MCP Server

A Rust implementation of the Machine Communication Protocol (MCP) server, designed for efficient and reliable communication between machines and tools.

Features

• Multiple Transport Layers: Supports both stdio and Server-Sent Events (SSE) transports
• Extensible Tool System: Easily register custom tools with the server
• Type-Safe API: Leverages Rust's type system for safe and reliable communication
• Asynchronous Design: Built on tokio for high-performance async I/O
• Progress Reporting: Built-in support for streaming progress updates

Installation

Add this to your Cargo.toml:

[dependencies]
tiny_mcp_server = "0.1.0"

Quick Start

use serde_json::{Value, json};
use std::error::Error;
use tiny_mcp_server::*;

#[mcp_tool(
    description = "Greeting from tiny_mcp_server",
    version = "1.0.0",
    category = "testing"
)]
pub async fn say_hello(name: String) -> MCPResult<Value> {
    Ok(json!({
        "greeting": format!("Hello {name}")
    }))
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    server::start_stdio().await
}

The tiny_mcp_server crate re-exports all necessary dependencies, so you don't need to manually add tiny_mcp_macro, tiny_mcp_types, tiny_mcp_registry, inventory, or async-trait to your project.

Documentation

For more detailed documentation, see the API documentation.

Examples

Check out the examples directory for more usage examples:

• stdio.rs: Example using stdio transport
• sse.rs: Example using SSE transport
• common/mod.rs: Various tool implementations demonstrating different features

License

This project is licensed under either of:

• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.