Remote MCP Server On Cloudflare Pqx

🚀 在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。

• 启动Inspector：npx @modelcontextprotocol/inspector
• 配置连接信息：在Inspector中，切换传输类型为SSE，并在URL字段输入http://localhost:8787/sse，然后点击“连接”
• 登录操作：你会重定向到一个（模拟的）用户登录界面。输入任意电子邮件和密码进行登录。
• 调用工具：成功登录后，你可以在MCP Inspector中列出并调用任何定义的工具！

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

使用Claude时，我们需要更新配置文件以便其与我们的MCP服务器通信。按照Anthropic的快速入门指南，在Claude Desktop中打开设置并编辑配置文件。 将配置文件内容替换为以下内容：

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

这样，Claude将通过本地代理与你的MCP服务器通信。启动Claude后，浏览器窗口会打开并提示你登录。完成登录后，工具列表会在右下角显示。

🔧 部署到Cloudflare

创建KV命名空间

使用wrangler创建KV命名空间：

wrangler kv:namespace create mcp-namespace --binding=MCP_NAMESPACE

更新配置文件

更新wrangler.jsonc文件，添加以下内容：

{
  "kv_accounts": {
    "MCP_NAMESPACE": "your-namespace-id"
  }
}

🔍 从远程MCP客户端调用

• 启动Inspector：npx @modelcontextprotocol/inspector
• 在URL字段输入https://your-deployed-endpoint/sse，然后点击“连接”

🐞 调试

• 如果遇到问题，请尝试重启Claude或直接通过命令行连接到MCP服务器：

npx mcp-remote http://localhost:8787/sse

• 如果仍然无法解决问题，请检查并清除认证文件：

rm ~/.config/mcp/auth

通过以上步骤，你可以顺利完成从本地开发到远程部署的整个流程。