cargo-pmcp

Production-grade MCP server development toolkit.

Overview

cargo-pmcp is a comprehensive scaffolding and development tool for building Model Context Protocol (MCP) servers using the PMCP SDK. It streamlines the entire lifecycle from project creation to production deployment.

Features

• Project Scaffolding - Create workspaces and add servers with best-practice templates
• Development Mode - Build and run servers with HTTP transport and live logs
• Client Connection - One-command setup for Claude Code, Cursor, and MCP Inspector
• Automated Testing - Generate and run scenario-based tests from server capabilities
• Load Testing - Stress-test with concurrent virtual users, latency histograms, and CI/CD reports
• Schema Management - Export, validate, and diff schemas from live MCP servers
• Workflow Validation - Catch structural errors in workflows before runtime
• MCP Apps - Scaffold widget projects, generate ChatGPT manifests, and build landing pages
• Widget Preview - Browser-based preview with dual proxy/WASM bridge modes and hot-reload
• Multi-Target Deployment - Deploy to AWS Lambda, Google Cloud Run, Cloudflare Workers, or pmcp.run
• Secrets Management - Multi-provider secret storage (local, pmcp.run, AWS Secrets Manager)
• OAuth Authentication - Production-ready OAuth 2.0 with AWS Cognito, Dynamic Client Registration, and SSO
• Landing Pages - Create, develop, and deploy landing pages for server discovery

Installation

cargo install cargo-pmcp

End-to-End Example

Walk through the full lifecycle using the complete template calculator server.

1. Create workspace and add a server

cargo pmcp new my-mcp-workspace
cd my-mcp-workspace
cargo pmcp add server calculator --template complete

2. Start the dev server

cargo pmcp dev --server calculator

Server starts on http://0.0.0.0:3000 with live logs.

3. Connect to Claude Code

In another terminal:

cargo pmcp connect --server calculator --client claude-code

Now ask Claude: "Multiply 7 and 8" or "Solve x^2 - 5x + 6 = 0".

4. Generate and run tests

# Generate test scenarios from server capabilities
cargo pmcp test generate --server calculator

# Run the tests
cargo pmcp test run --server calculator --detailed

5. Load test

# Generate starter config with schema discovery
cargo pmcp loadtest init https://my-server.example.com

# Run load test
cargo pmcp loadtest run https://my-server.example.com --vus 20 --duration 60

6. Deploy

# Initialize for AWS Lambda with OAuth
cargo pmcp deploy init --target aws-lambda --oauth cognito

# Deploy
cargo pmcp deploy --target aws-lambda

7. Monitor

cargo pmcp deploy logs --tail
cargo pmcp deploy metrics --period 24h
cargo pmcp deploy test --verbose

Commands

Global Flags

OAuth Authentication

Enable OAuth 2.0 for your MCP server with zero code changes. Supports AWS Cognito, Microsoft Entra ID, Google, Okta, and Auth0.

Infrastructure setup:

cargo pmcp deploy init --target aws-lambda --oauth cognito

Server-side (provider-agnostic):

use pmcp::server::auth::AuthContext;

fn handle_tool_call(auth: &AuthContext) -> Result<Value, Error> {
    auth.require_auth()?;
    auth.require_scope("read:data")?;
    let user_id = auth.user_id();
    Ok(json!({ "user": user_id }))
}

Switch providers via config only (no code changes):

[profile.production.auth]
type = "jwt"
issuer = "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_xxxxx"
audience = "your-app-client-id"

For detailed OAuth architecture, see docs/oauth-design.md and docs/oauth-sdk-design.md.

CI/CD Integration

cargo-pmcp supports OAuth 2.0 client credentials flow for automated deployments.

export PMCP_CLIENT_ID="your-client-id"
export PMCP_CLIENT_SECRET="your-client-secret"
cargo pmcp deploy --target pmcp-run

GitHub Actions

name: Deploy MCP Server
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - run: cargo install cargo-pmcp
      - name: Deploy
        env:
          PMCP_CLIENT_ID: ${{ secrets.PMCP_CLIENT_ID }}
          PMCP_CLIENT_SECRET: ${{ secrets.PMCP_CLIENT_SECRET }}
        run: cargo pmcp deploy --target pmcp-run

Environment Variables

Requirements

• Rust 1.70 or later

License

MIT

Contributing

See the main PMCP SDK repository for contributing guidelines.