🚀 Nchan MCP Transport

by ConechoAI

29 stars

370 downloads

Not rated

GitHub

Other

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

Author: ConechoAI
GitHub stars: 29
Downloads: 370
Categories: Other

- Dual protocol support: WebSocket and SSE with automatic detection
- High performance pub/sub built on Nginx + Nchan
- Fully MCP‑compliant transport (JSON‑RPC 2.0)
- Auto‑generate MCP tools from any OpenAPI spec
- Use Python decorators to register tools and resources
- Background task queue with live progress updates via push
- Dockerized deployment ready

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 Transport

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 nchan mcp transport": {
            "nchan-mcp-transport": {
                "command": "python",
                "args": [
                    "-m",
                    "httmcp",
                    "-f",
                    "gpt_actions_openapi.json",
                    "-p",
                    "http://nchan:80"
                ]
            }
        }
    }
}

From the repository

Install the server SDK with pip install httmcp, then clone the repository and run docker-compose up -d. Define tools using Python decorators (@server.tool()), optionally expose OpenAPI services with OpenAPIMCP.from_openapi(), or use the CLI for one‑click GPTs Actions to MCP deployment.

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"
        ]
    }
}

🚀 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:

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 Nchan MCP Transport

✨ What is this?

🧩 Key Features

🧠 Why Use This?

🚀 Quickstart

📦 1. Install server SDK

🧪 2. Run demo in Docker

🛠 3. Define your tool

🧬 4. Expose OpenAPI service (optional)

🖥️ 5. One-Click GPTs Actions to MCP Deployment

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀