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集成。