CHUK MCP Runtime

Version 0.10.4 - Pydantic-Native Artifact Integration

A robust runtime for the official Model Context Protocol (MCP) — adds proxying, session management, JWT auth, persistent user storage with scopes, and progress notifications.

✅ Continuously tested against the latest official MCP SDK releases for guaranteed protocol compatibility.

---

CHUK MCP Runtime extends the official MCP SDK, adding a battle-tested runtime layer for real deployments — without modifying or re-implementing the protocol.

Architecture

┌──────────────────────────┐
│  Client / Agent          │
│  (Claude, OpenAI, etc.)  │
└───────────┬──────────────┘
            │
            ▼
┌──────────────────────────┐
│  CHUK MCP Runtime        │
│  - Proxy Manager         │
│  - Session Manager       │
│  - Artifact Storage      │
│  - Resource Provider     │
│  - JWT Auth & Progress   │
└───────────┬──────────────┘
            │
            ▼
┌──────────────────────────┐
│  MCP SDK Servers & Tools │
│  (Official MCP Protocol) │
└──────────────────────────┘

Why CHUK MCP Runtime?

• 🔌 Multi-Server Proxy - Connect multiple MCP servers through one unified endpoint
• 🔐 Secure by Default - All built-in tools disabled unless explicitly enabled
• 🌐 Universal Connectivity - stdio, SSE, and HTTP transports supported
• 🔧 OpenAI Compatible - Transform MCP tools into OpenAI function calling format
• 📊 Progress Notifications - Real-time progress reporting for long operations
• ⚡ Production Features - Session isolation, timeout protection, JWT auth
• 📦 Storage Scopes (NEW v0.9) - Session (ephemeral), User (persistent), Sandbox (shared)

Quick Start (30 seconds)

Run any official MCP server (like mcp-server-time) through the CHUK MCP Runtime proxy:

chuk-mcp-proxy --stdio time --command uvx -- mcp-server-time

That’s it! You now have a running MCP proxy with tools like proxy.time.get_current_time (default 60s tool timeout).

ℹ️ Tip: Everything after -- is forwarded to the stdio child process (here: mcp-server-time).

💡 Windows: Install uv and use uvx from a shell with it on PATH, or replace --command uvx -- mcp-server-time with your Python launcher. Note that mcp-server-time may expose a Python module name like mcp_server_time depending on install method (e.g., py -m mcp_server_time).