Remote MCP Server On Cloudflare Q3y

🚀 在Cloudflare上運行遠程MCP服務器

本項目將幫助你搭建一個運行在Cloudflare Workers上的遠程MCP服務器，並集成OAuth登錄功能，讓你可以輕鬆地與Claude Desktop和MCP檢查器進行交互。

🚀 快速開始

本地開發

首先，你需要在本地環境中克隆倉庫、安裝依賴並啟動本地服務。以下是具體的操作步驟：

# 克隆倉庫
git clone git@github.com:cloudflare/ai.git

# 安裝依賴
cd ai
npm install

# 啟動本地服務
npx nx dev remote-mcp-server

啟動成功後，你可以在瀏覽器中打開http://localhost:8787/查看效果。

💻 使用示例

將MCP檢查器連接到你的服務器

你可以使用MCP檢查器來探索新的MCP API，具體操作步驟如下：

1. 使用以下命令啟動MCP檢查器：npx @modelcontextprotocol/inspector。
2. 在檢查器中，將傳輸類型切換為SSE，並在URL中輸入http://localhost:8787/sse以連接到你的MCP服務器，然後點擊“連接”。
3. 此時你會被重定向到一個（模擬）用戶密碼登錄界面，輸入任意電子郵件和密碼進行登錄。
4. 成功登錄後，你將返回到MCP檢查器，並能夠列出和調用任何已定義的工具。

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

按照Anthropic的快速入門指南，在Claude Desktop中轉到設置 > 開發者 > 編輯配置文件以找到你的配置文件。用文本編輯器打開該文件，並將其替換為以下內容：

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

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

📦 安裝指南

部署到Cloudflare

要將項目部署到Cloudflare，你需要完成以下步驟：

1. 註冊並設置Upstash：
   • 前往Upstash註冊一個免費賬戶。
   • 創建一個新的Postgres數據庫，並獲取連接字符串（格式為postgres://user:password@host:port/database）。
2. 更新配置文件：
   • 在項目的根目錄下，創建或編輯.env文件，添加以下內容：

UPSTASH_URL=your_upstash_host
UPSTASH_USER=username
UPSTASH_PASSWORD=password

- 替換`your_upstash_host`、`username`和`password`為你的實際Upstash憑據。

3. 部署到Cloudflare Pages：
   • 初始化你的項目倉庫為Git倉庫（如果尚未完成）。
   • 創建一個package.json文件，包含以下內容：

{
  "name": "mcp-server",
  "version": "1.0.0",
  "scripts": {
    "dev": "npx nx dev remote-mcp-server",
    "build": "npx nx build --configuration production"
  },
  "dependencies": {
    "@nx/webpack": "^14.0.0",
    "express": "^4.18.2",
    "pg": "^8.11.3",
    "typescript": "^5.3.2",
    "@types/node": "^20.11.0"
  }
}

- 在項目的根目錄下創建一個`tsconfig.json`文件，內容如下：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "outDir": "./dist",
    "rootDir": ".",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

- 接下來，創建一個`pages.json`文件以配置Cloudflare Pages：

{
  "type": "static",
  "build": {
    "command": "npm run build",
    "directory": "./dist"
  },
  "routes": [
    "* => $latest"
  ]
}

- 現在，你可以將項目推送到GitHub或GitLab，並連接到Cloudflare Pages以進行部署。

🔧 調試

如果在部署或使用過程中遇到問題，請參考以下步驟進行調試：

1. 檢查Cloudflare Pages的構建日誌，確保所有依賴項正確安裝且沒有錯誤。
2. 驗證Upstash憑據是否正確配置在.env文件中，並且沒有拼寫錯誤。
3. 確保MCP服務器在本地運行無誤後，再嘗試部署到生產環境。

通過以上步驟，你已經成功搭建了一個功能齊全的遠程MCP服務器，並能夠與Claude Desktop和MCP檢查器無縫集成。