🚀 Nchan MCP Transport
About
The best way to deploy mcp server. A high-performance WebSocket/SSE transport layer & gateway for Anthropic's MCP (Model Context Protocol) — powered by Nginx, Nchan, and FastAPI.
Details
- License
- MIT
Explore
| 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 |
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🚀 Nchan MCP TransportCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install httmcp[cli]
pip install httmcp
HTTMCP provides a powerful CLI for instant deployment of GPTs Actions to MCP servers:
python -m httmcp -f gpt_actions_openapi.json -p http://nchan:80
---
@server.tool()
async def search_docs(query: str) -> str:
return f"Searching for {query}..."
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\ude80 nchan mcp transport": {
"nchan-mcp-transport": {
"command": "python",
"args": [
"-m",
"httmcp",
"-f",
"gpt_actions_openapi.json",
"-p",
"http://nchan:80"
]
}
}
}
}McpServers
{
"nchan-mcp-transport": {
"command": "python",
"args": [
"-m",
"httmcp",
"-f",
"gpt_actions_openapi.json",
"-p",
"http://nchan:80"
]
}
}> 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:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
