chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
salman1993 merged 1 commit into from
Mar 3, 2025
Merged

chore: move examples out of various places into a top-level examples/ #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion Cargo.toml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
"crates/*",
"examples/clients",
"examples/servers",
"examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down
84 changes: 84 additions & 0 deletions examples/README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.
33 changes: 33 additions & 0 deletions examples/clients/Cargo.toml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"
0 crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs
View file
Open in desktop
File renamed without changes.
0 crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs
View file
Open in desktop
File renamed without changes.
0 crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs
View file
Open in desktop
File renamed without changes.
0 .../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs
View file
Open in desktop
File renamed without changes.
18 changes: 18 additions & 0 deletions examples/macros/Cargo.toml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"
0 crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs
View file
Open in desktop
File renamed without changes.
22 changes: 22 additions & 0 deletions examples/servers/Cargo.toml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"
0 crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs
View file
Open in desktop
File renamed without changes.
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.


, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
chore: move examples out of various places into a top-level examples/#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

salman1993
merged 1 commit into

from

Mar 3, 2025
 Merged


chore: move examples out of various places into a top-level examples/
#10
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


7 changes: 6 additions & 1 deletion
Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
[workspace]
members = ["crates/*"]
members = [
 "crates/*",
 "examples/clients",
 "examples/servers",
 "examples/macros"
]
resolver = "2"

[workspace.dependencies]
Expand Down

84 changes: 84 additions & 0 deletions
examples/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
# Model Context Protocol Examples

This directory contains examples demonstrating how to use the Model Context Protocol (MCP) Rust SDK.

## Structure

- `clients/`: Examples of MCP clients
- `servers/`: Examples of MCP servers
- `macros/`: Examples of MCP macros

## Running Client Examples

The client examples demonstrate different ways to connect to MCP servers.

### Available Examples

You can run the examples in two ways:

#### Option 1: From the examples/clients directory

```bash
cd examples/clients
cargo run --example clients
cargo run --example sse
cargo run --example stdio
cargo run --example stdio_integration
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-client-examples --example clients
cargo run -p mcp-client-examples --example sse
cargo run -p mcp-client-examples --example stdio
cargo run -p mcp-client-examples --example stdio_integration
```

## Running Server Examples

The server examples demonstrate how to implement MCP servers.

### Available Examples

You can run the server examples in two ways:

#### Option 1: From the examples/servers directory

```bash
cd examples/servers
cargo run --example counter-server
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-server-examples --example counter-server
```

## Running Macros Examples

The macros examples demonstrate how to use the MCP macros to create tools.

### Available Examples

You can run the macros examples in two ways:

#### Option 1: From the examples/macros directory

```bash
cd examples/macros
cargo run --example calculator
```

#### Option 2: From the root directory

```bash
cargo run -p mcp-macros-examples --example calculator
```

## Notes

- Some examples may require additional setup or running both client and server components.
- The server examples use standard I/O for communication, so they can be connected to client examples using stdio transport.
- For SSE examples, you may need to run a separate SSE server or use a compatible MCP server implementation.

33 changes: 33 additions & 0 deletions
examples/clients/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
[package]
name = "mcp-client-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-client = { path = "../../crates/mcp-client" }
mcp-core = { path = "../../crates/mcp-core" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
rand = "0.8"
futures = "0.3"
anyhow = "1.0"

[[example]]
name = "clients"
path = "src/clients.rs"

[[example]]
name = "sse"
path = "src/sse.rs"

[[example]]
name = "stdio"
path = "src/stdio.rs"

[[example]]
name = "stdio_integration"
path = "src/stdio_integration.rs"

0
crates/mcp-client/examples/clients.rs → examples/clients/src/clients.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/sse.rs → examples/clients/src/sse.rs

View file


Open in desktop


File renamed without changes.


0
crates/mcp-client/examples/stdio.rs → examples/clients/src/stdio.rs

View file


Open in desktop


File renamed without changes.


0
.../mcp-client/examples/stdio_integration.rs → examples/clients/src/stdio_integration.rs

View file


Open in desktop


File renamed without changes.


18 changes: 18 additions & 0 deletions
examples/macros/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
[package]
name = "mcp-macros-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
async-trait = "0.1"
schemars = "0.8"

[[example]]
name = "calculator"
path = "src/calculator.rs"

0
crates/mcp-macros/examples/calculator.rs → examples/macros/src/calculator.rs

View file


Open in desktop


File renamed without changes.


22 changes: 22 additions & 0 deletions
examples/servers/Cargo.toml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
[package]
name = "mcp-server-examples"
version = "0.1.0"
edition = "2021"
publish = false

[dependencies]
mcp-server = { path = "../../crates/mcp-server" }
mcp-core = { path = "../../crates/mcp-core" }
mcp-macros = { path = "../../crates/mcp-macros" }
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
anyhow = "1.0"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
futures = "0.3"

[[example]]
name = "counter-server"
path = "src/counter_server.rs"

0
crates/mcp-server/src/main.rs → examples/servers/src/counter_server.rs

View file


Open in desktop


File renamed without changes.