feat: add Rust binary calculator example

First example of the binary server type — a compiled Rust MCP server
packaged as an MCPB. Based on the official Rust SDK calculator example
(rmcp 1.2.0, 2 tools: sum/sub, ~80 LOC).

Includes Cargo.toml, Dockerfile for Docker-based builds, .mcpbignore
to exclude source from the bundle, and README with build/pack/test
instructions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

examples/README.md

@@ -14,11 +14,12 @@ But, the MCP servers themselves are not robust secure production ready servers a
 
 ## Examples Included
 
-| Example               | Type    | Demonstrates                             |
-| --------------------- | ------- | ---------------------------------------- |
-| `hello-world-node`    | Node.js | Basic MCP server with simple time tool   |
-| `chrome-applescript`  | Node.js | Browser automation via AppleScript       |
-| `file-manager-python` | Python  | File system operations and path handling |
+| Example               | Type    | Demonstrates                                |
+| --------------------- | ------- | ------------------------------------------- |
+| `hello-world-node`    | Node.js | Basic MCP server with simple time tool      |
+| `chrome-applescript`  | Node.js | Browser automation via AppleScript          |
+| `file-manager-python` | Python  | File system operations and path handling    |
+| `calculator-rust`     | Binary  | Compiled Rust binary as MCP Bundle          |
 
 ## Usage
 

examples/calculator-rust/.gitignore

@@ -0,0 +1,3 @@
+target/
+Cargo.lock
+server/mcp-calculator

examples/calculator-rust/.mcpbignore

@@ -0,0 +1,7 @@
+Cargo.toml
+Cargo.lock
+src/
+target/
+Dockerfile
+README.md
+.gitignore

examples/calculator-rust/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "mcp-calculator"
+version = "1.0.0"
+edition = "2024"
+
+[dependencies]
+rmcp = { version = "1.2.0", features = ["server", "macros", "transport-io", "schemars"] }
+tokio = { version = "1", features = ["macros", "rt-multi-thread", "io-std"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+anyhow = "1.0"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter", "std", "fmt"] }
+schemars = "1.0"
+
+[profile.release]
+strip = true
+lto = true

examples/calculator-rust/Dockerfile

@@ -0,0 +1,11 @@
+FROM rust:1.94-bookworm AS builder
+
+WORKDIR /app
+COPY Cargo.toml ./
+COPY src/ ./src/
+
+RUN cargo build --release
+
+FROM debian:bookworm-slim
+COPY --from=builder /app/target/release/mcp-calculator /mcp-calculator
+ENTRYPOINT ["/mcp-calculator"]

examples/calculator-rust/README.md

@@ -0,0 +1,87 @@
+# Calculator Rust Binary Example
+
+Demonstrates packaging a compiled Rust binary as an MCP Bundle using the `binary` server type. Based on the [official Rust MCP SDK calculator example](https://github.com/modelcontextprotocol/rust-sdk/tree/main/examples/servers).
+
+## What is Binary Server Type?
+
+Unlike `node` or `uv` server types where the source code is bundled and executed by a runtime, the `binary` server type packages a pre-compiled native executable. This is useful for:
+
+- Rust, Go, C/C++ MCP servers
+- Performance-sensitive workloads
+- Servers with no runtime dependencies
+
+The tradeoff is that binaries are platform-specific — you need a separate build for each target OS/architecture.
+
+## Structure
+
+```
+calculator-rust/
+├── manifest.json       # server.type = "binary"
+├── Cargo.toml          # Rust project
+├── Dockerfile          # Build via Docker
+├── .mcpbignore         # Exclude source from bundle
+├── .gitignore          # Exclude build artifacts
+└── src/
+    └── main.rs         # Calculator MCP server (~80 LOC)
+```
+
+After building, the `server/` directory is created with the compiled binary.
+
+## Building
+
+### Native (requires Rust 1.85+)
+
+```bash
+cd examples/calculator-rust
+cargo build --release
+mkdir -p server
+cp target/release/mcp-calculator server/
+```
+
+### Docker (no local Rust required)
+
+```bash
+cd examples/calculator-rust
+docker build -t mcp-calculator .
+# Extract the binary (linux only)
+docker create --name calc mcp-calculator
+docker cp calc:/mcp-calculator server/mcp-calculator
+docker rm calc
+chmod +x server/mcp-calculator
+```
+
+## Packing
+
+```bash
+mcpb pack examples/calculator-rust
+```
+
+The `.mcpbignore` file excludes source code and build artifacts — only `manifest.json` and `server/mcp-calculator` end up in the bundle.
+
+## Testing
+
+```bash
+# MCP protocol handshake
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
+  | ./server/mcp-calculator
+
+# Tool call
+(printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}\n'
+printf '{"jsonrpc":"2.0","method":"notifications/initialized"}\n'
+printf '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"sum","arguments":{"a":3,"b":4}}}\n'
+sleep 1) | ./server/mcp-calculator
+```
+
+Expected: `sum(3, 4)` returns `{"text":"7"}`.
+
+## Tools
+
+- **sum** — Calculate the sum of two numbers
+- **sub** — Calculate the difference of two numbers
+
+## Notes
+
+- Binary size: ~2.5 MB (stripped, LTO enabled)
+- The `Cargo.toml` uses `edition = "2024"` (Rust 1.85+)
+- Logs are written to stderr via `tracing`, so they don't interfere with MCP's stdio transport
+- Uses the [rmcp](https://crates.io/crates/rmcp) crate (official Rust MCP SDK)

examples/calculator-rust/manifest.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "../../dist/mcpb-manifest.schema.json",
+  "manifest_version": "0.3",
+  "name": "calculator-rust",
+  "display_name": "Calculator (Rust Binary)",
+  "version": "1.0.0",
+  "description": "A simple calculator MCP server compiled from Rust",
+  "long_description": "Demonstrates packaging a compiled Rust binary as an MCP Bundle using the binary server type. The server provides sum and sub tools for basic arithmetic. Based on the official Rust MCP SDK calculator example.",
+  "author": {
+    "name": "Model Context Protocol"
+  },
+  "server": {
+    "type": "binary",
+    "entry_point": "server/mcp-calculator",
+    "mcp_config": {
+      "command": "${__dirname}/server/mcp-calculator",
+      "args": [],
+      "env": {}
+    }
+  },
+  "tools": [
+    {
+      "name": "sum",
+      "description": "Calculate the sum of two numbers"
+    },
+    {
+      "name": "sub",
+      "description": "Calculate the difference of two numbers"
+    }
+  ],
+  "keywords": ["calculator", "rust", "binary", "example"],
+  "license": "Apache-2.0",
+  "compatibility": {
+    "platforms": ["darwin", "linux"]
+  }
+}

examples/calculator-rust/src/main.rs

@@ -0,0 +1,80 @@
+use anyhow::Result;
+use rmcp::{
+    ServerHandler, ServiceExt,
+    handler::server::{router::tool::ToolRouter, wrapper::Parameters},
+    model::{ServerCapabilities, ServerInfo},
+    schemars, tool, tool_handler, tool_router,
+    transport::stdio,
+};
+use tracing_subscriber::{self, EnvFilter};
+
+// --- Calculator types ---
+
+#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
+pub struct SumRequest {
+    #[schemars(description = "the left hand side number")]
+    pub a: i32,
+    pub b: i32,
+}
+
+#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
+pub struct SubRequest {
+    #[schemars(description = "the left hand side number")]
+    pub a: i32,
+    #[schemars(description = "the right hand side number")]
+    pub b: i32,
+}
+
+// --- Calculator server ---
+
+#[derive(Debug, Clone)]
+pub struct Calculator {
+    tool_router: ToolRouter<Self>,
+}
+
+#[tool_router]
+impl Calculator {
+    pub fn new() -> Self {
+        Self {
+            tool_router: Self::tool_router(),
+        }
+    }
+
+    #[tool(description = "Calculate the sum of two numbers")]
+    fn sum(&self, Parameters(SumRequest { a, b }): Parameters<SumRequest>) -> String {
+        (a + b).to_string()
+    }
+
+    #[tool(description = "Calculate the difference of two numbers")]
+    fn sub(&self, Parameters(SubRequest { a, b }): Parameters<SubRequest>) -> String {
+        (a - b).to_string()
+    }
+}
+
+#[tool_handler]
+impl ServerHandler for Calculator {
+    fn get_info(&self) -> ServerInfo {
+        ServerInfo::new(ServerCapabilities::builder().enable_tools().build())
+            .with_instructions("A simple calculator".to_string())
+    }
+}
+
+// --- Main ---
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    tracing_subscriber::fmt()
+        .with_env_filter(EnvFilter::from_default_env().add_directive(tracing::Level::DEBUG.into()))
+        .with_writer(std::io::stderr)
+        .with_ansi(false)
+        .init();
+
+    tracing::info!("Starting Calculator MCP server");
+
+    let service = Calculator::new().serve(stdio()).await.inspect_err(|e| {
+        tracing::error!("serving error: {:?}", e);
+    })?;
+
+    service.waiting().await?;
+    Ok(())
+}