Nchan MCP Transport

🚀 Nchan MCP 傳輸協議

一個高性能的 WebSocket/SSE 傳輸層網關，用於 Anthropic 的 MCP（模型上下文協議） —— 由 Nginx、Nchan 和 FastAPI 提供支持。適用於構建 即時且可擴展的 AI 集成，與 Claude 和其他 LLM 代理通信。

🚀 快速開始

📦 1. 安裝服務器 SDK

pip install httmcp

🧪 2. 使用 Docker 運行示例

git clone https://github.com/yourusername/nchan-mcp-transport.git
cd nchan-mcp-transport
docker-compose up -d

🛠 3. 定義你的工具

@server.tool()
async def search_docs(query: str) -> str:
    return f"正在搜索 {query}..."

🧬 4. 暴露 OpenAPI 接口（可選）

如果你需要暴露 OpenAPI 接口，可以這樣做：

uvicorn server.main:app --reload

然後在瀏覽器中訪問 http://localhost:8000/docs。

✨ 主要特性

這是什麼？

Nchan MCP 傳輸協議 提供了一個 即時 API 網關，用於 MCP 客戶端（如 Claude）與其工具和服務之間通過以下方式通信：

• 🧵 WebSocket 或 服務器發送事件 (SSE)
• ⚡️ 可流式 HTTP 兼容
• 🧠 由 Nginx + Nchan 提供支持，實現 低延遲的發佈/訂閱
• 🛠 集成 FastAPI 用於後端邏輯和 OpenAPI 工具鏈

✅ 適用於 AI 開發者構建 Claude 插件、LLM 代理 或將 外部 API 集成到 Claude 中的 MCP 協議。

核心功能

為什麼使用這個項目？

MCP 允許像 Claude 這樣的 AI 助手與外部工具通信。但：

• 原生 MCP 使用 HTTP + SSE，在處理 長任務、網絡不穩定 和 高併發 時表現不佳
• WebSocket 並不被 Claude 原生支持 —— 此項目 彌合了這一差距
• 服務器端的純 Python 實現（如 FastMCP）在負載下可能 無法擴展

✅ Nchan MCP 傳輸協議 提供：

• Web 級別性能（Nginx/Nchan）
• FastAPI 驅動的後端邏輯
• Claude 客戶端即時事件交付
• 即插即用 OpenAPI 到 Claude 集成

🤝 貢獻

歡迎提出拉取請求！如果有任何問題或想改進以下方面，請提交 issue：

• 性能優化
• 部署改進
• SDK 集成

📄 許可證

MIT License