Cloudflare 上的远程 MCP 服务器

让我们在 Cloudflare Workers 上启动并运行一个带有 OAuth 登录的远程 MCP 服务器！

本地开发

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

# 安装依赖
cd ai
npm install

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

你应该能够在浏览器中打开 http://localhost:8787/

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

要探索你的新 MCP API，你可以使用 MCP 检查器。

• 使用 npx @modelcontextprotocol/inspector 启动它
• 在检查器中，将传输类型切换到 SSE，并输入 http://localhost:8787/sse 作为要连接的 MCP 服务器的 URL。
• 添加一个 bearer token 并点击 "Connect"
• 点击 "List Tools"
• 运行 "getToken" 工具，它应该返回你在检查器中设置的 Authorization header

<div align="center"> <img src="img/mcp-inspector-sse-config.png" alt="MCP Inspector with the above config" width="600"/> </div>

<div align="center"> <img src="img/mcp-inspector-successful-tool-call.png" alt="MCP Inspector with after a tool call" width="600"/> </div>

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

    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer {token}"
      ]
    }

部署到 Cloudflare

npm run deploy

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

就像你在 "本地开发" 中所做的那样，运行 MCP 检查器：

npx @modelcontextprotocol/inspector@latest

然后在检查器中输入你的 Worker 的 workers.dev URL (例如：worker-name.account-name.workers.dev/sse) 作为要连接的 MCP 服务器的 URL，然后点击 "Connect"。

你现在已经从远程 MCP 客户端连接到你的 MCP 服务器。 你可以像上面提到的那样传入一个 bearer token

将 Claude Desktop 连接到你的远程 MCP 服务器

TODO: 我们需要支持 mcp-remote 代理的任意 headers

调试

如果出现任何问题，重新启动 Claude 可能会有所帮助，或者尝试使用以下命令直接从命令行连接到你的 MCP 服务器。

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

在极少数情况下，清除添加到 ~/.mcp-auth 的文件可能会有所帮助

rm -rf ~/.mcp-auth