Remote MCP Server On Cloudflare B9s

🚀 在Cloudflare上搭建远程MCP服务器

本项目将指导你搭建一个运行于Cloudflare Workers上的远程MCP服务器，并集成OAuth登录功能，助你轻松探索MCP API的强大功能。

🚀 快速开始

本地开发

在本地环境中启动项目，按照以下步骤操作：

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

# 安装依赖
cd ai
npm install

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

启动成功后，你可以在浏览器中打开http://localhost:8787/查看效果。

将MCP检查器连接到你的服务器

若要探索新的MCP API，可使用MCP检查器，具体操作如下：

• 使用npx @modelcontextprotocol/inspector启动检查器。
• 在检查器界面（http://localhost:5173），将传输类型切换为SSE，并在URL中输入http://localhost:8787/sse作为MCP服务器地址，然后点击“连接”。
• 进入模拟登录界面，输入任意邮箱和密码完成登录。
• 成功登录后，即可在检查器中列出并调用任何已定义的工具！

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

MCP检查器虽实用，但我们更希望将其与Claude集成。按照Anthropic的快速入门指南，在Claude Desktop中进入设置 > 开发者 > 编辑配置文件，打开该文件并用以下内容替换：

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

这样会运行一个本地代理，使Claude能够通过HTTP与你的MCP服务器通信。启动Claude后，浏览器窗口应打开，并提示你登录。你可以在右下角看到可用工具列表，根据正确的提示，Claude可能会要求调用某个工具。

部署到Cloudflare

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

1. 登录Cloudflare Dashboard。
2. 选择你的站点或创建新站点。
3. 转至“Workers” > “Create a Script”，并填写相关信息（如名称、文件路径等）。
4. 确保启用相关设置，例如允许访问敏感信息。
5. 保存脚本并部署。

完成部署后，你的MCP服务器将托管在Cloudflare上，并可通过其分配的域名访问。

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

部署成功后，你可以通过curl命令进行测试：

curl -X POST http://your-domain/some-endpoint

根据你的具体实现，调整请求参数和路径。确保在实际使用前检查文档和日志，以确保一切正常运行。

🔧 故障排除

在使用过程中遇到问题，可参考以下解决方案：

• 问题：无法连接到MCP服务器

  • 检查网络是否正常。
  • 确保Cloudflare Workers已正确部署。
  • 查看Cloudflare控制台是否有错误日志。

• 问题：登录失败

  • 确保OAuth配置正确，并且密钥有效。
  • 检查身份验证流程中的每一步骤，确保没有遗漏。

• 问题：工具未列出或无法调用

  • 查看MCP服务器的API文档，确认端点和参数是否正确。
  • 使用curl命令手动测试相关接口。

通过以上步骤，你应该能够顺利搭建、连接和使用远程MCP服务器，并在出现问题时快速定位和解决。祝你在探索MCP协议的过程中一切顺利！