Remote MCP Server On Cloudflare Imy

🚀 在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 inspector連接到你的服務器

要探索新的MCP API，你可以使用 MCP Inspector，具體步驟如下：

• 使用 npx @modelcontextprotocol/inspector 啟動它。
• 在Inspector中，切換傳輸類型為 SSE 並輸入 http://localhost:8787/sse 作為MCP服務器的URL進行連接，然後點擊“連接”。
• 你將導航到一個（模擬）用戶密碼登錄界面。輸入任意電子郵件和密碼進行登錄。
• 你應該被重定向回MCP Inspector，並且可以列出並調用任何已定義的工具！

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

Inspector雖然有用，但我們真正想做的是將其與Claude連接！按照 Anthropic的快速入門指南，在Claude Desktop中轉到 設置 > 開發者 > 編輯配置 以找到配置文件。 在文本編輯器中打開該文件，並用以下配置替換：

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

這將運行一個本地代理，使Claude能夠通過HTTP與你的MCP服務器通信。 當你打開Claude時，瀏覽器窗口應打開，並允許你進行登錄。你應該在右下角看到可用工具的列表。根據提示，正確的提示會使Claude調用工具。

部署到Cloudflare

創建KV命名空間

# 在終端運行以下命令創建新的KV命名空間
cf create kv_NAMESPACE_NAME

更新wrangler配置

1. 打開 project.env。
2. 添加以下內容：

   KV_NAMESPACE_ID=your-namespace-id
   KV_NAMESPACE_NAME=your-namespace-name
   

3. 保存文件並運行部署命令：

   npx wrangler dev
   

從遠程MCP客戶端連接

使用MCP Inspector

1. 打開Inspector並輸入你的Cloudflare Workers URL。
2. 點擊“連接”進行通信。

使用Claude Desktop

1. 修改Claude的配置文件，指定你的Cloudflare URL。
2. 重啟Claude應用以應用更改。

🔧 調試技巧

• 重啟Claude：如果遇到問題，請確保你已正確修改了配置文件，並且已重啟Claude應用。
• 清除緩存：在某些情況下，清除 .mcp 目錄中的緩存文件可能會有所幫助。

  rm -rf .mcp/*
  

通過以上步驟，你應該能夠成功搭建並使用遠程MCP服務器。