Remote MCP Server On Cloudflare Pqx

🚀 在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。

• 啟動Inspector：npx @modelcontextprotocol/inspector
• 配置連接信息：在Inspector中，切換傳輸類型為SSE，並在URL字段輸入http://localhost:8787/sse，然後點擊“連接”
• 登錄操作：你會重定向到一個（模擬的）用戶登錄界面。輸入任意電子郵件和密碼進行登錄。
• 調用工具：成功登錄後，你可以在MCP Inspector中列出並調用任何定義的工具！

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

使用Claude時，我們需要更新配置文件以便其與我們的MCP服務器通信。按照Anthropic的快速入門指南，在Claude Desktop中打開設置並編輯配置文件。 將配置文件內容替換為以下內容：

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

這樣，Claude將通過本地代理與你的MCP服務器通信。啟動Claude後，瀏覽器窗口會打開並提示你登錄。完成登錄後，工具列表會在右下角顯示。

🔧 部署到Cloudflare

創建KV命名空間

使用wrangler創建KV命名空間：

wrangler kv:namespace create mcp-namespace --binding=MCP_NAMESPACE

更新配置文件

更新wrangler.jsonc文件，添加以下內容：

{
  "kv_accounts": {
    "MCP_NAMESPACE": "your-namespace-id"
  }
}

🔍 從遠程MCP客戶端調用

• 啟動Inspector：npx @modelcontextprotocol/inspector
• 在URL字段輸入https://your-deployed-endpoint/sse，然後點擊“連接”

🐞 調試

• 如果遇到問題，請嘗試重啟Claude或直接通過命令行連接到MCP服務器：

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

• 如果仍然無法解決問題，請檢查並清除認證文件：

rm ~/.config/mcp/auth

通過以上步驟，你可以順利完成從本地開發到遠程部署的整個流程。