🚀 Nchan MCP 运输层

高性能的WebSocket/SSE传输层及网关，用于Anthropic的MCP（模型上下文协议）——由Nginx、Nchan和FastAPI提供支持。
适用于构建与Claude和其他大型语言模型代理的实时可扩展AI集成。

---

✨ 这是什么？

Nchan MCP 运输层 提供了一个实时API网关，使MCP客户端（如Claude）能够通过以下方式与您的工具和服务通信：

• 🧵 WebSocket 或 服务器发送事件（SSE）
• ⚡️ 流式HTTP 兼容
• 🧠 由Nginx + Nchan提供支持，实现低延迟发布/订阅
• 🛠 与FastAPI集成，用于后端逻辑和OpenAPI工具

✅ 对于正在构建Claude插件、大型语言模型代理或通过MCP将外部API集成到Claude中的AI开发者来说，这是理想的解决方案。

---

🧩 主要特性

特性	描述
🔄 双协议支持	无缝支持WebSocket 和 SSE，并自动检测
🚀 高性能发布/订阅	基于Nginx + Nchan，处理数千个并发连接
🔌 符合MCP规范的传输	完全实现了模型上下文协议（JSON-RPC 2.0）
🧰 OpenAPI集成	根据任何OpenAPI规范自动生成MCP工具
🪝 工具/资源系统	使用Python装饰器注册工具和资源
📡 异步执行	后台任务队列+通过推送通知实时更新进度
🧱 Docker化部署	使用Docker Compose轻松启动

---

🧠 为什么使用这个？

MCP让像Claude这样的AI助手能够与外部工具通信。但是：

• 原生MCP是HTTP+SSE，在处理长时间任务、网络不稳定和高并发时会遇到困难
• WebSockets不被Claude原生支持——这个项目填补了这一空白
• 纯Python的服务器端逻辑（如FastMCP）可能在负载下无法扩展

✅ Nchan MCP 运输层为您提供：

• Web规模性能（Nginx/Nchan）
• 由FastAPI驱动的工具后端
• 实时事件传递给Claude客户端
• 开箱即用的OpenAPI到Claude集成

---

🚀 快速开始

📦 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_server = await OpenAPIMCP.from_openapi("https://example.com/openapi.json", publish_server="http://nchan:80")
app.include_router(openapi_server.router)

🖥️ 5. 一键将GPTs Actions部署到MCP服务器

HTTMCP提供了一个强大的CLI，用于即时部署GPTs Actions到MCP服务器：

# 安装
pip install httmcp[cli]

# 从GPTs Actions OpenAPI规范一键部署
python -m httmcp -f gpt_actions_openapi.json -p http://nchan:80

---

📚 使用案例

• 通过WebSocket/SSE的Claude插件服务器
• 实时的大型语言模型代理后端（类似于LangChain/AutoGen风格）
• 将Claude连接到内部API（通过OpenAPI）
• 高性能的MCP工具/服务桥接

---

🔒 要求

• 带有Nchan模块的Nginx（Docker镜像中预安装）
• Python 3.9+
• Docker / Docker Compose

---

🛠 技术栈

• 🧩 Nginx + Nchan – 持久连接管理和发布/订阅
• ⚙️ FastAPI – 后端逻辑及JSON-RPC路由
• 🐍 HTTMCP SDK – 完整的MCP协议实现
• 🐳 Docker – 部署就绪

---

📎 关键词

mcp运输层, nchan websocket, anthropic sse, mcp jsonrpc网关, claude插件后端, 流式http, 实时ai api网关, fastapi websocket mcp, mcp发布/订阅, mcp openapi桥接

---

🤝 贡献

欢迎提交拉取请求！如果您希望帮助改进，请提交问题：

• 性能
• 部署
• SDK集成

---

📄 许可证

MIT许可证