Rust MCP Server Starter Template

🎉 Now cargo-generate compatible! Generate your custom MCP server with a single command.

A production-ready, well-documented starter template for building Model Context Protocol (MCP) servers in Rust. This template provides a complete foundation with working examples, production logging, and flexible configuration.

✨ Features

• 🚀 Production Ready: Complete implementation with comprehensive error handling and logging
• 🔧 Flexible Configuration: TOML files + environment variables + CLI arguments (figment-based)
• 📝 Structured Logging: Production logging with file rotation and multiple outputs (tracing ecosystem)
• 🌐 Multiple Transports:
  • stdio transport for child process communication
  • HTTP/SSE transport for network communication with graceful shutdown
• 🛠️ Complete MCP Support:
  • Tools: Callable functions with parameters and structured responses
  • Resources: Read-only data access for server metadata
  • Prompts: User-controlled templates for AI assistant interactions
• 📊 Example Implementations:
  • Echo tool (simple string input/output)
  • Calculator tool (structured parameters with JSON result)
  • Stateful counter tool (demonstrates shared state with Arc<Mutex<T>>)
• 🏗️ Modular Architecture: Library + binary pattern for easy extension and testing
• 🧪 Comprehensive Testing: Unit tests and integration tests for both transports

🚀 Quick Start

Prerequisites

• Rust 1.85+ (Rust 2024 edition)
• cargo

🚀 Quick Start

Recommended: Use cargo-generate

# Install cargo-generate if you don't have it
cargo install cargo-generate

# Generate your custom MCP server
cargo generate --git https://github.com/furbyhaxx/mcp-server-rs-template

# Follow the prompts to customize your project!

Manual Installation

# Clone the template
git clone https://github.com/yourusername/rmcp-starter-template.git
cd rmcp-starter-template

# Build the project
cargo build --release

# Run with stdio transport (default)
cargo run -- serve

# Run with explicit transport selection
cargo run -- serve --transport stdio
cargo run -- serve --transport http

Test the Tools

Once running, you can interact with the built-in tools:

Echo Tool:

# Example MCP client interaction (simplified)
{
  "tool": "echo",
  "arguments": {
    "message": "Hello, MCP!"
  }
}
# Returns: "Echo: Hello, MCP!"

Calculator Tool:

{
  "tool": "calculate",
  "arguments": {
    "a": 10.5,
    "b": 5.2,
    "operation": "add"
  }
}
# Returns: {"result": 15.7, "operation": "add", "operands": [10.5, 5.2]}

Counter Tools:

{
  "tool": "get_counter"
}
# Returns: "Current counter value: 0"

{
  "tool": "increment_counter",
  "arguments": {
    "amount": 3
  }
}
# Returns: "Counter incremented by 3. New value: 3"

{
  "tool": "reset_counter"
}
# Returns: "Counter reset to 0"

⚙️ Configuration

The template supports three layers of configuration (in priority order):

1. CLI Arguments (highest priority)
2. Environment Variables (prefix: MCP_)
3. TOML Files (default: config/default.toml)

Configuration Files

• config/default.toml: Default configuration with sensible defaults
• .env.example: Environment variable template

Environment Variables

# Override server name
MCP_SERVER_NAME="my-mcp-server"

# Set log level to debug
MCP_LOGGING_LEVEL="debug"

# Configure HTTP transport port
MCP_TRANSPORT_HTTP_PO

... [View full README on GitHub](https://github.com/furbyhaxx/mcp-server-rs-template#readme)