Remote MCP Server On Cloudflare Qc2

🚀 在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服务器

MCP inspector很好用，但我们更希望将其与Claude连接！按照Anthropic的快速入门指南操作，并在Claude Desktop中进入“设置>开发者>编辑配置”找到你的配置文件。

打开该文件并在文本编辑器中替换为以下内容：

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

这将运行一个本地代理，使Claude能够通过HTTP与你的MCP服务器通信。

当你打开Claude时，浏览器窗口会打开并允许你登录。你应该在右下角看到可用的工具列表。根据提示输入正确的指令，Claude会调用MCP服务器上的工具。

🔧 部署到Cloudflare

1. 在终端中运行以下命令创建KV命名空间：

   wrangler kv namespace create --name mcp-config
   

2. 更新wrangler.toml文件，添加你的Cloudflare账户信息和新的KV命名空间ID。
3. 最后运行部署命令：

   npm run build && wrangler deploy
   

🔧 调试

如果遇到问题，请尝试以下操作：

1. 重启Claude应用程序或检查配置文件路径是否正确。
2. 如果仍然有问题，可以删除缓存文件：

   rm -rf ~/.mcp-auth