Remote MCP Server On Cloudflare T56

🚀 在Cloudflare上远程运行MCP服务器

本项目将带领你在Cloudflare Workers上搭建一个远程MCP服务器，并集成OAuth登录功能，让你轻松体验相关服务！

🚀 快速开始

本地开发

在本地开发环境中搭建项目，你可以按照以下步骤操作：

# 克隆仓库
git clone git@github.com:cloudflare/ai.git

# 安装依赖
cd ai
npm install

# 本地运行
npx nx dev remote-mcp-server

操作完成后，你可以通过浏览器打开http://localhost:8787/来访问项目。

将MCP Inspector连接到你的服务器

若要探索新的MCP API，你可以使用MCP Inspector，具体步骤如下：

• 使用npx @modelcontextprotocol/inspector启动它。
• 在Inspector中，切换传输类型为SSE，并输入http://localhost:8787/sse作为MCP服务器的URL，然后点击“连接”。
• 你会跳转到一个（模拟）用户登录界面。输入任意邮箱和密码进行登录。
• 成功登录后，你应该会被重定向回MCP Inspector，并能够列出和调用任何已定义的工具！

将Claude Desktop连接到本地MCP服务器

使用Inspector虽然不错，但我们更希望将其与Claude集成！按照Anthropic的快速入门指南，在Claude Desktop中进入设置 > 开发者 > 编辑配置文件，找到你的配置文件。 用文本编辑器打开该文件，并将其替换为以下内容：

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

这样会运行一个本地代理，允许Claude通过HTTP与你的MCP服务器通信。 打开Claude时，浏览器窗口应显示登录界面。你应该能够看到可用工具列表。根据正确的提示，Claude可能会请求调用某个工具。

部署到Cloudflare

将项目部署到Cloudflare，你可以按照以下步骤操作：

1. npx wrangler kv namespace create OAUTH_KV
2. 按照指南添加kv命名空间ID到wrangler.jsonc
3. npm run deploy

从远程MCP客户端调用你的新部署的远程MCP服务器

就像在“本地开发”部分所做的那样，运行MCP Inspector： npx @modelcontextprotocol/inspector@latest 然后在Inspector中输入你的Worker域名（例如：worker-name.account-name.workers.dev/sse）作为MCP服务器的URL，并点击“连接”。

将Claude Desktop连接到Cloudflare上的MCP服务器

按照与本地相同的步骤，将Claude配置为使用部署在Cloudflare上的MCP服务器。

🔧 故障排除和注意事项

• ⚠️ 重要提示
  • 确保所有端点和服务已正确配置。
  • 检查网络连接和防火墙设置，确保所有必要的端口开放。
  • 在生产环境中，请遵循安全最佳实践，保护敏感数据并启用适当的身份验证机制。