🚀 Nchan MCP 传输协议

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

✨ 这是什么？

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 集成

🚀 快速入门

📦 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。

🤝 贡献

欢迎提出拉取请求！如果有任何问题或想改进以下方面，请提交 issue：

• 性能优化
• 部署改进
• SDK 集成

📄 许可证

MIT License