TurboMCP

v1.0.0Developer Toolsstable

A full featured, enterprise grade rust MCP SDK

mcpmcp-clientmcp-sdkmcp-servermcp-servers
Share:
86
Stars
0
Downloads
0
Weekly
0/5

What is TurboMCP?

TurboMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to full featured, enterprise grade rust mcp sdk

A full featured, enterprise grade rust MCP SDK

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A full featured, enterprise grade rust MCP SDK

Use Cases

Build enterprise-grade MCP servers using the Rust SDK.
Create production-ready MCP implementations in Rust.
Develop high-performance MCP clients and servers.
Epistates

Maintainer

LicenseMIT
Languagerust
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx turbomcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use TurboMCP

TurboMCP is an enterprise-grade Rust SDK for building high-performance MCP servers and clients. It provides compile-time JSON schema generation from decorated Rust methods, multiple transport backends (STDIO, HTTP, WebSocket, TCP, Unix sockets), built-in telemetry, and full protocol compliance — all selected at runtime via a TRANSPORT environment variable. Rust developers use TurboMCP when they need production-ready MCP infrastructure with memory safety, minimal latency, and native binary distribution.

Prerequisites

  • Rust 1.75 or later with Cargo installed
  • Tokio async runtime (included as a dependency)
  • An MCP-compatible client such as Claude Desktop or Cursor to test your server
  • Basic familiarity with Rust macros and async/await
1

Add TurboMCP to your Cargo.toml

Add turbomcp and tokio as dependencies in your Rust project. Use the 'full' feature flag to enable all transports and telemetry.

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

Define your server struct and annotate tools

Create a struct annotated with #[server] and add methods with #[tool], #[resource], or #[prompt] to register them as MCP capabilities. TurboMCP generates JSON schemas at compile time.

use turbomcp::prelude::*;

#[server(name = "my-server", version = "1.0.0")]
struct MyServer;

#[tool]
impl MyServer {
    async fn greet(&self, name: String) -> String {
        format!("Hello, {}!", name)
    }
}
3

Select a transport and run the server

Set the TRANSPORT environment variable to choose the transport backend, then call the appropriate run method. STDIO is the default for MCP client integrations.

# Default STDIO (for MCP clients):
./my-server

# HTTP transport on port 8080:
TRANSPORT=http ./my-server

# TCP transport on port 9000:
TRANSPORT=tcp ./my-server
4

Build the release binary

Compile your server to a standalone native binary for distribution or deployment. The binary requires no Rust runtime on the target machine.

cargo build --release
# Binary at: ./target/release/my-server
5

Configure your MCP client to use the binary

Point your Claude Desktop or Cursor config to the compiled binary. The server speaks the MCP protocol over STDIO by default.

TurboMCP Examples

Client configuration

Add your compiled TurboMCP server binary to Claude Desktop. Replace the path with your actual binary location.

{
  "mcpServers": {
    "my-turbomcp-server": {
      "command": "/path/to/target/release/my-server",
      "args": [],
      "env": {
        "TRANSPORT": "stdio"
      }
    }
  }
}

Prompts to try

Example interactions once your TurboMCP server tools are registered with the client.

- "Call the greet tool with my name and show the response"
- "List all available tools on the my-turbomcp-server MCP server"
- "Fetch the config://app resource from the server"
- "Use the server's calculate tool to add 1523 and 8877"

Troubleshooting TurboMCP

Compilation fails with 'proc macro panicked' or schema generation error

Ensure all tool method parameters implement serde::Deserialize and serde::Serialize. TurboMCP generates JSON schemas at compile time and requires fully serializable types.

MCP client shows the server as disconnected immediately after starting

Confirm the TRANSPORT variable is unset or set to 'stdio' when connecting via Claude Desktop or Cursor, since those clients use STDIO. HTTP/TCP transports are for separate network deployments.

Tool is registered but does not appear in the client's tool list

Verify that the #[tool] macro is applied to impl block methods (not free functions) and that the server struct is annotated with #[server]. Rebuild with 'cargo build --release' after any macro changes.

Frequently Asked Questions about TurboMCP

What is TurboMCP?

TurboMCP is a Model Context Protocol (MCP) server that full featured, enterprise grade rust mcp sdk It connects AI assistants to external tools and data sources through a standardized interface.

How do I install TurboMCP?

Follow the installation instructions on the TurboMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with TurboMCP?

TurboMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is TurboMCP free to use?

Yes, TurboMCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "turbomcp": { "command": "npx", "args": ["-y", "turbomcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use TurboMCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides