🚀 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