Remote MCP Server On Cloudflare B9s

🚀 在Cloudflare上搭建遠程MCP服務器

本項目將指導你搭建一個運行於Cloudflare Workers上的遠程MCP服務器，並集成OAuth登錄功能，助你輕鬆探索MCP API的強大功能。

🚀 快速開始

本地開發

在本地環境中啟動項目，按照以下步驟操作：

# 克隆倉庫
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檢查器，具體操作如下：

• 使用npx @modelcontextprotocol/inspector啟動檢查器。
• 在檢查器界面（http://localhost:5173），將傳輸類型切換為SSE，並在URL中輸入http://localhost:8787/sse作為MCP服務器地址，然後點擊“連接”。
• 進入模擬登錄界面，輸入任意郵箱和密碼完成登錄。
• 成功登錄後，即可在檢查器中列出並調用任何已定義的工具！

將Claude Desktop連接到本地MCP服務器

MCP檢查器雖實用，但我們更希望將其與Claude集成。按照Anthropic的快速入門指南，在Claude Desktop中進入設置 > 開發者 > 編輯配置文件，打開該文件並用以下內容替換：

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

這樣會運行一個本地代理，使Claude能夠通過HTTP與你的MCP服務器通信。啟動Claude後，瀏覽器窗口應打開，並提示你登錄。你可以在右下角看到可用工具列表，根據正確的提示，Claude可能會要求調用某個工具。

部署到Cloudflare

將項目部署到Cloudflare，按以下步驟操作：

1. 登錄Cloudflare Dashboard。
2. 選擇你的站點或創建新站點。
3. 轉至“Workers” > “Create a Script”，並填寫相關信息（如名稱、文件路徑等）。
4. 確保啟用相關設置，例如允許訪問敏感信息。
5. 保存腳本並部署。

完成部署後，你的MCP服務器將託管在Cloudflare上，並可通過其分配的域名訪問。

從遠程客戶端調用部署後的MCP服務器

部署成功後，你可以通過curl命令進行測試：

curl -X POST http://your-domain/some-endpoint

根據你的具體實現，調整請求參數和路徑。確保在實際使用前檢查文檔和日誌，以確保一切正常運行。

🔧 故障排除

在使用過程中遇到問題，可參考以下解決方案：

• 問題：無法連接到MCP服務器

  • 檢查網絡是否正常。
  • 確保Cloudflare Workers已正確部署。
  • 查看Cloudflare控制檯是否有錯誤日誌。

• 問題：登錄失敗

  • 確保OAuth配置正確，並且密鑰有效。
  • 檢查身份驗證流程中的每一步驟，確保沒有遺漏。

• 問題：工具未列出或無法調用

  • 查看MCP服務器的API文檔，確認端點和參數是否正確。
  • 使用curl命令手動測試相關接口。

通過以上步驟，你應該能夠順利搭建、連接和使用遠程MCP服務器，並在出現問題時快速定位和解決。祝你在探索MCP協議的過程中一切順利！