turbomcp

TurboMCP is a production-ready Rust SDK for building MCP servers with zero-boilerplate development and progressive enhancement. It enables you to define servers using procedural macros, automatically generate JSON schemas from function signatures, and expose multiple transports such as STDIO, HTTP/SSE, WebSocket, and more depending on the feature flags you enable. The library emphasizes type-safe handlers, context injection, and a rich toolkit for building scalable MCP-enabled services. To get started, you typically create a Rust project, add turbomcp as a dependency, and implement a server using the provided #[server] and #[tool] attributes, then run the server with your chosen transport preset (e.g., stdio for quick tests or full for production-ready transport coverage).

Prerequisites:

• Rust 1.89.0+ (Edition 2024)
• Rust toolchain (rustup recommended)

Step 1: Install Rust

• Follow the instructions at https://www.rust-lang.org/tools/install

Step 2: Create a new Rust project (if you don’t have one)

• cargo new turbomcp-server
• cd turbomcp-server

Step 3: Add turbomcp to your Cargo.toml

[dependencies]
turbomcp = "3.0.0-beta.5"
tokio = { version = "1", features = ["full"] }

Step 4: Build and run

• cargo build
• cargo run

If you prefer to quickly generate a production-ready server, you can also pull a ready-to-run example or use the package directly in a project and enable the desired feature presets (default, full, full-stack, network) in your Cargo.toml.

Tips and considerations:

• Feature presets control which MCP transports and capabilities are compiled in. Use default for STDIO-only development, and full/full-stack for production-grade transports and context features.
• OAuth 2.1 authentication (auth) is available as a feature; enable it if your deployments require secure client authentication.
• SIMD acceleration (simd) can boost JSON processing performance for high-throughput servers.
• Ensure you select transports that match your deployment environment (e.g., STDIO for local tests, HTTP/SSE for web integrations, WebSocket for bidirectional clients, TCP for network services).
• The library provides automatic JSON schema generation from Rust types, reducing boilerplate in tool and resource handlers. Be mindful of type changes that affect the generated schema.
• When deploying via Docker, ensure the container has access to necessary runtime resources (TLS certificates, environment variables for OAuth providers, etc.).