Cloudflare Remote MCP Server

Cloudflare Remote MCP 服务

一个运行在 Cloudflare Workers 和 Durable Objects 上的 Model Context Protocol（MCP）服务实现。

功能

• 远程 MCP 服务：基于 HTTP Streamable 传输，可通过互联网访问的 MCP 服务
• Durable Objects：使用 Cloudflare Durable Objects 处理有状态请求
• 示例工具：用于演示 MCP 协议的工具
• 示例资源：可通过 MCP 访问的静态数据资源
• 示例提示词：预构建的 AI 交互提示词
• CORS 支持：支持跨域资源共享，适用于 Web

架构

┌─────────────────┐  HTTP POST + SSE  ┌──────────────────┐
│   MCP Client    │ ◄──────────────► │ Cloudflare       │
│   (AI/Claude)   │                  │ Worker           │
└─────────────────┘                  └─────────┬────────┘
                                               │
                                               ▼
                                     ┌──────────────────┐
                                     │ MCPServerObject  │
                                     │ (Durable Object) │
                                     │                  │
                                     │ • MCP Protocol   │
                                     │ • HTTP Processing│
                                     │ • Request State  │
                                     └──────────────────┘

可用功能

工具

• echo：回显输入文本
• get_time：获取当前时间戳
• random_number：生成 min 和 max 之间的随机数

资源

• cloudflare://worker-info：关于 Cloudflare Worker 的信息
• cloudflare://sample-data：用于测试的示例 JSON 数据

提示词

• explain_code：生成用于解释代码的提示词
• debug_help：生成用于调试协助的提示词

部署

1. 安装依赖项：

   npm install
   

2. 部署到 Cloudflare：

   npm run deploy
   

3. 通过部署后的 URL 访问你的 MCP 服务

开发

1. 启动本地开发：

   npm run dev
   

2. 测试服务：

   # Get server info
   curl http://localhost:8787/
   
   # Test MCP endpoint with a simple request
   curl -X POST http://localhost:8787/mcp \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
   

用法

HTTP API

• GET / - 服务信息和功能
• POST /mcp - MCP HTTP Streamable 端点

MCP 连接

将 MCP 客户端连接到 HTTP 端点：

• 本地：http://localhost:8787/mcp
• 生产环境：https://your-worker.your-subdomain.workers.dev/mcp

协议详情

服务使用 HTTP Streamable 传输：

• 请求：HTTP POST，请求正文中包含 JSON-RPC 消息
• 响应：Server-Sent Events（SSE）流，内容类型为 text/event-stream
• 格式：每个响应均以 data: {JSON}\n\n 的形式发送

MCP 消息示例

列出工具

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

调用工具

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "echo",
      "arguments": {
        "text": "Hello, MCP!"
      }
    }
  }'

列出资源

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "resources/list"
  }'

配置

服务在 wrangler.jsonc 中配置：

• Durable Objects：MCPServerObject 负责处理有状态的 MCP 请求
• 兼容日期：设置为当前日期，以使用最新的 Cloudflare Workers 功能

开发说明

• 使用 @modelcontextprotocol/sdk 实现 MCP 协议
• HTTP 请求由 Durable Objects 处理，以管理状态
• 响应通过 Server-Sent Events（SSE）流式传输
• 启用 CORS，以兼容 Web 客户端
• 错误处理包括 JSON-RPC 错误响应
• 启用严格模式的 TypeScript

传输协议

此实现使用 HTTP Streamable 传输，而非 WebSocket：

• 与代理和防火墙的兼容性更好
• 使用标准 HTTP 语义
• 支持通过 Server-Sent Events 实时响应
• 更适合无状态云环境

许可证

这是一个用于教育目的的示例实现。