Rust

Rust-based PMCP server tooling with scaffolding, testing, and production-ready patterns.

rust

41

GitHub Stars

rust

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "paiml-rust-mcp-sdk": {
      "command": "cargo",
      "args": [
        "pmcp",
        "dev",
        "--server",
        "weather"
      ]
    }
  }
}

PMCP provides a Rust-based framework to build production-grade MCP servers with high performance, strong safety guarantees, and integrated testing and observability. You can scaffold, develop, test, and deploy MCP servers that expose tools and workflows using multiple transports, all while following quality practices inspired by Toyota Way principles.

How to use

You will work with a local MCP server that runs in stdio mode, interacting with an MCP client through standard input and output. Start development with the weather example server, then use your MCP client to invoke tools, pass typed arguments, and receive structured results. You can iterate quickly with hot-reload development if supported by your tooling, and you will benefit from comprehensive tests and structured logging built into the server framework.

How to install

Prerequisites: you need Rust installed to build and run MCP servers.

Install Rust and update your toolchain.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup update

Install the MCP development toolkit for Rust projects.

cargo install cargo-pmcp

Create a new weather MCP workspace and set up a minimal weather server template. Then start the development server in stdio mode.

# Create workspace
cargo pmcp new weather-mcp-workspace
cd weather-mcp-workspace

# Add a weather server from a minimal template
cargo pmcp add server weather --template minimal

# Start development server for weather
cargo pmcp dev --server weather

Additional notes

You can also generate tests, run quality checks, and build for production using the same tooling. If you plan to deploy, consider how you will monitor logs and metrics, enable observability, and manage deployments across environments.

Troubleshooting and tips

If the development server does not start, verify Rust toolchain availability and that the weather server name matches your configuration. Check for missing dependencies and ensure you are running from the project root where the MCP workspace was created.

Examples and patterns

The weather MCP example illustrates how to define a server that exposes a weather-fetching tool and runs with typed tools, validation, and observability. Use this pattern as a starting point for your own domain-specific MCP servers.

Available tools

ServerBuilder

A builder to assemble an MCP server, configure its name, version, and available tools, and then run it.

TypedTool

Tool definitions that enforce type-safe arguments and generate JSON schemas for clients.

RequestHandlerExtra

Extended request handling context passed to tools for additional metadata and control.

mcp-tester

A testing tool to validate MCP server implementations across transports and protocols.