🚀 Nchan MCP Transport
A high-performance WebSocket/SSE transport layer & gateway for Anthropic's MCP (Model Context Protocol) — powered by Nginx, Nchan, and FastAPI.
For building real-time, scalable AI integrations with Claude and other LLM agents.
✨ What is this?
Nchan MCP Transport provides a real-time API gateway for MCP clients (like Claude) to talk to your tools and services over:
- 🧵 WebSocket or Server-Sent Events (SSE)
- ⚡️ Streamable HTTP compatible
- 🧠 Powered by Nginx + Nchan for low-latency pub/sub
- 🛠 Integrates with FastAPI for backend logic and OpenAPI tooling
✅ Ideal for AI developers building Claude plugins, LLM agents, or integrating external APIs into Claude via MCP.
🧩 Key Features
| Feature | Description |
|---|---|
| 🔄 Dual Protocol Support | Seamlessly supports WebSocket and SSE with automatic detection |
| 🚀 High Performance Pub/Sub | Built on Nginx + Nchan, handles thousands of concurrent connections |
| 🔌 MCP-Compliant Transport | Fully implements Model Context Protocol (JSON-RPC 2.0) |
| 🧰 OpenAPI Integration | Auto-generate MCP tools from any OpenAPI spec |
| 🪝 Tool / Resource System | Use Python decorators to register tools and resources |
| 📡 Asynchronous Execution | Background task queue + live progress updates via push notifications |
| 🧱 Dockerized Deployment | Easily spin up with Docker Compose |
🧠 Why Use This?
MCP lets AI assistants like Claude talk to external tools. But:
- Native MCP is HTTP+SSE, which struggles with long tasks, network instability, and high concurrency
- WebSockets aren’t natively supported by Claude — this project bridges the gap
- Server-side logic in pure Python (like
FastMCP) may not scale under load
✅ Nchan MCP Transport gives you:
- Web-scale performance (Nginx/Nchan)
- FastAPI-powered backend for tools
- Real-time event delivery to Claude clients
- Plug-and-play OpenAPI to Claude integration
🚀 Quickstart
📦 1. Install server SDK
pip install httmcp
🧪 2. Run demo in Docker
git clone https://github.com/yourusername/nchan-mcp-transport.git
cd nchan-mcp-transport
docker-compose up -d
🛠 3. Define your tool
@server.tool()
async def search_docs(query: str) -> str:
return f"Searching for {query}..."
🧬 4. Expose OpenAPI service (optional)
openapi_server = await OpenAPIMCP.from_openapi("https://example.com/openapi.json", publish_server="http://nchan:80")
app.include_router(openapi_server.router)
🖥️ 5. One-Click GPTs Actions to MCP Deployment
HTTMCP provides a powerful CLI for instant deployment of GPTs Actions to MCP servers:
# Installation
pip install httmcp[cli]
# One-click deployment from GPTs Actions OpenAPI spec
python -m httmcp -f gpt_actions_openapi.json -p http://nchan:80
📚 Use Cases
- Claude plugin server over WebSocket/SSE
- Real-time LLM agent backend (LangChain/AutoGen style)
- Connect Claude to internal APIs (via OpenAPI)
- High-performance tool/service bridge for MCP
🔒 Requirements
- Nginx with Nchan module (pre-installed in Docker image)
- Python 3.9+
- Docker / Docker Compose
🛠 Tech Stack
- 🧩 Nginx + Nchan – persistent connection management & pub/sub
- ⚙️ FastAPI – backend logic & JSON-RPC routing
- 🐍 HTTMCP SDK – full MCP protocol implementation
- 🐳 Docker – deployment ready
📎 Keywords
mcp transport, nchan websocket, sse for anthropic, mcp jsonrpc gateway, claude plugin backend, streamable http, real-time ai api gateway, fastapi websocket mcp, mcp pubsub, mcp openapi bridge
🤝 Contributing
Pull requests are welcome! File issues if you’d like to help improve:
- Performance
- Deployment
- SDK integrations
📄 License
MIT License