MCP服务器

Cloudflare Worker托管的MCP服务器,通过HTTP暴露MCP传输,并委托给Atlas Agent工具,由Cloudflare KV命名空间支持。

  • by atlas-agent
  • TypeScript
  • 云端部署
  • 更新于
在 GitHub 查看 atlas-agent/cloudflare-mcp-demo

使用说明

Cloudflare MCP演示

此Cloudflare Worker托管了一个由以下组件构建的MCP服务器 mcp-liteWorker通过HTTP公开MCP传输,同时将工作委托给Cloudflare KV命名空间支持的Atlas Agent工具。

HTTP表面

  • POST /mcp --通过以下方式传输MCP协议流量 StreamableHttpTransport每个请求都包含一个KV绑定 authInfo.extra 所以工具可以触及秘密。
  • GET / --基本健康对策("MCP Server - Connect to /mcp").

注册MCP工具

  • generate_sales_comps --验证 listingAddress 和 email 然后联系阿特拉斯特工 salesCMA 报告API。
  • generate_rental_comps --使用相同的验证和流程 rentalCMA 报告类型。

两种工具:

  • 解决 atlas-agent-mcp-server 上下文通过 ctx.authInfo.extra.
  • 阅读 ATLAS_AGENT_API_KEY 在发出出站请求之前,从Cloudflare KV绑定中删除。
  • 将成功/错误有效载荷标准化为纯文本MCP内容。

架构流程

flowchart LR
    Client[Atlas MCP client] -->|POST /mcp| Hono
    Hono --> Transport[Streamable\nHTTP transport]
    Transport --> Server[McpServer]
    Server -->|tool call| Tools{sales or rental}
    Tools --> KV[Cloudflare KV\n(Atlas Agent API key)]
    Tools --> AtlasAPI[Atlas Agent POST endpoint]
    AtlasAPI --> Tools --> Server --> Transport --> Client

配置说明

  • 将KV命名空间绑定为 KV_NAMESPACE 所以 ctx.authInfo.extra.kvNamespace 可用。
  • 确保命名空间存储 ATLAS_AGENT_API_KEY缺失的钥匙短路,MCP错误。
  • Worker依赖于平台 fetch 实施;不需要额外的HTTP客户端。