TurboMCP

Production-ready Rust SDK for the Model Context Protocol (MCP) with zero-boilerplate macros, modular transport architecture, and WASM support.

TurboMCP 3.0 is a major architectural release featuring a modular 25-crate workspace, unified error handling, no_std core for edge/WASM deployment, individual transport crates, and full MCP 2025-11-25 specification compliance. See the Migration Guide for upgrading from v1 or v2.

Quick Start

[dependencies]
turbomcp = "3.0.2"
tokio = { version = "1", features = ["full"] }

use turbomcp::prelude::*;

#[derive(Clone)]
struct Calculator;

#[server(name = "calculator", version = "1.0.0")]
impl Calculator {
    /// Add two numbers together.
    #[tool]
    async fn add(&self, a: i64, b: i64) -> i64 {
        a + b
    }

    /// Multiply two numbers.
    #[tool]
    async fn multiply(&self, a: i64, b: i64) -> i64 {
        a * b
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    Calculator.run_stdio().await?;
    Ok(())
}

Save, cargo run, and connect from Claude Desktop:

{
  "mcpServers": {
    "calculator": {
      "command": "/path/to/your/server",
      "args": []
    }
  }
}

Requirements

• Rust 1.89.0+ (Edition 2024)
• Tokio async runtime

Feature Flags

TurboMCP uses feature flags for progressive enhancement. The default is stdio only.

Presets

| Preset | Includes | Use Case | |--------|----------|----------| | default | STDIO | CLI tools, Claude Desktop | | minimal | STDIO | Same as default (explicit) | | full | STDIO, HTTP, WebSocket, TCP, Unix, Telemetry | Production servers | | full-stack | Full + all client transports | Server + Client development | | all-transports | All transports + channel | Testing and benchmarks |

Individual Features

| Feature | Description | |---------|-------------| | stdio | Standard I/O transport (default) | | http | HTTP/SSE with Axum integration | | websocket | WebSocket bidirectional transport | | tcp | Raw TCP socket transport | | unix | Unix domain socket transport | | channel | In-process channel (zero-overhead testing) | | telemetry | OpenTelemetry, metrics, structured logging | | auth | OAuth 2.1 with PKCE and multi-provider support | | dpop | DPoP (RFC 9449) proof-of-possession | | client-integration | Client library with STDIO transport | | full-client | Client library with all transports |

# Production server with all transports and telemetry
turbomcp = { version = "3.0.2", features = ["full"] }

# Add authentication
turbomcp = { version = "3.0.2", features = ["full", "auth"] }

# Server + client for full-stack development
turbomcp = { version = "3.0.2", features = ["full-stack"] }

Procedural Macros

TurboMCP provides five attribute macros:

| Macro | Purpose | |-------|---------| | #[server] | Define an MCP server with name, version, and transport configuration | | #[tool] | Register a method as a tool handler with automatic JSON schema generation | | #[resource] | Register a resource handler with URI pattern matching | | #[prompt] | Register a prompt template with parameter substitution | | #[description] | Add rich descriptions to tool parameters |

Server Definition

use turbomcp::prelude::*;

#[derive(Clone)]
struct MyServer;

#[server(
    name = "my-server",
    version = "1.0.0",
    description = "A server with tools, resources, and prompts"
)]
impl MyServer {
    //

... [View full README on GitHub](https://github.com/Epistates/turbomcp#readme)