only_mcp

一个简单的 MCP v0.2 客户端和服务端实现，供我学习 MCP 使用。

这不是一个完整的实现，也不应该用于生产环境。

目前进展

花了一个周末实现了 MCP v0.2——正如听起来一样有趣！代理现在可以利用经过身份验证的工具，尽管还有改进的空间。

主要观察：

• 协议变更：MCP v0.2 与 v0.1 显著不同——最值得注意的是，SSE 端点已消失。它还依赖于 .well-known OAuth 流程进行身份验证。引入 application/json 请求简化了一些交互，但也移除了通过 SSE 进行服务器推送的选项。

• SDK 和工具链的不足：当前用于快速构建 MCP 服务器的 Python SDK 仍然停留在 v0.2 版本，并且身份验证支持有限，这促使我构建一个与两种标准兼容的基于 Falcon 的服务器。开发工具链滞后——例如，Claude 集成仍然需要基于本地 stdio 的设置。有前景的 mcp-proxy 工具尚不支持 v0.2，导致实施过程中出现意外的绕道。

• 互操作性问题：MCP 的工具模式与 OpenAI 的 chat-completion 标准不同，这使得实现变得复杂。函数调用链（例如，在更新之前获取模式）也带来了挑战——工具调用工作流程可以更加简化。

• 长时间运行的任务：虽然直接支持仍然缺失，但 MCP v0.2 引入了用于任务状态轮询的事件 ID——这是一个受欢迎的补充，尽管尚未在我的设置中进行测试。

• 部署和策略：MCP 端点最好与 REST API 和 OAuth 流程共存，使其适合处理专用代理流量。Cloudflare 作为一个可靠的托管选项脱颖而出，但随着工具链的成熟，自托管可能会变得更可取。考虑在云中构建独立 MCP 网关的创始人可能需要重新评估该方法的长期可行性。

总的来说，MCP v0.2 进展顺利，但还需要几次迭代才能使工具链和 SDK 成熟。

开发者说明

1. Pre-commit

pre-commit install

1. 我们只在容器内进行开发。

docker compose up --build

1. 前端依赖项在本地管理。 如果您需要手动运行 eslint，请运行：

npm --prefix frontend install && npx eslint