Remote MCP Server1

🚀 在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检测工具连接到你的服务器

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

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

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

若想真正使用这个功能，需要将Claude与它连接起来。按照 Anthropic的快速入门指南，在Claude Desktop中打开设置 > 开发者 > 编辑配置文件。 找到该配置文件后，请用文本编辑器将其内容替换为以下配置：

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

这样，Claude将会通过一个本地代理与你的MCP服务器建立连接。当打开Claude时，默认会在浏览器中打开，并提示你进行登录。此时，你应该能够看到可用工具的列表。

🚀 部署到Cloudflare

要在Cloudflare上部署，可按以下步骤操作：

1. 使用以下命令创建 KV 命名空间：

   wrangler kv namespace create MCP_NAMESPACE_ID --name mcp-namespace
   

2. 更新 wrangler.toml 文件中的命名空间 ID，如下所示：

   [context."your accountId"].kv_namespaces = {
     "default" = "MCP_NAMESPACE_ID"
   }
   

🐞 调试

如果遇到问题，请尝试以下步骤：

1. 重启 Claude 应用程序。
2. 如果仍然无法解决问题，可以删除认证文件：

   rm -rf ~/.config/anthropic/
   

通过以上步骤，你将能够成功搭建并运行一个基于Cloudflare Workers的远程MCP服务器，并将其与Claude Desktop集成。