金大哥 - nchan-mcp-transport MCP 详情

article

README

🚀 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 协议。

🧩 核心功能

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

🧠 为什么使用这个项目？

MCP 允许像 Claude 这样的 AI 助手与外部工具通信。但：

原生 MCP 使用 HTTP + SSE，在处理 长任务、网络不稳定 和 高并发 时表现不佳
WebSocket 并不被 Claude 原生支持 —— 此项目 弥合了这一差距
服务器端的纯 Python 实现（如 FastMCP）在负载下可能 无法扩展

✅ Nchan MCP 传输协议 提供：

Web 级别性能（Nginx/Nchan）
FastAPI 驱动的后端逻辑
Claude 客户端实时事件交付
即插即用 OpenAPI 到 Claude 集成

🤝 贡献

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

性能优化
部署改进
SDK 集成

📄 许可证

MIT License

nchan-mcp-transport