My MCP Worker

🚀 使用 Cloudflare Workers 搭建 MCP 服務器

本項目藉助 Cloudflare Workers 搭建 MCP 服務器，模型上下文協議（MCP）作為開放標準，可實現 AI 代理和服務間的交互。通過搭建 MCP 服務器，能讓 AI 助手直接訪問你的 API。而 Cloudflare 工作者與 workers-mcp 包的結合，為構建 MCP 服務器提供了強大且可擴展的解決方案。

🚀 快速開始

準備工作

開始之前，請確保你具備以下內容：

• 一個 Cloudflare 賬戶
• Node.js 安裝完成
• Wrangler CLI 已安裝 (npm install -g wrangler)

創建 Cloudflare Worker

首先，初始化一個新的 Cloudflare Worker 項目：

npx create-cloudflare@latest my-mcp-worker
cd my-mcp-worker

然後，使用以下命令認證你的 Cloudflare 賬戶：

wrangler login

配置 Wrangler

更新你的 wrangler.toml 文件以包含正確的賬戶信息：

name = "my-mcp-worker"
main = "src/index.ts"
compatibility_date = "2025-03-03"
account_id = "your-account-id"

📦 安裝指南

安裝 MCP 工具

為了啟用 MCP 支持，安裝 workers-mcp 包：

npm install workers-mcp

運行以下命令進行設置：

npx workers-mcp setup

這將執行以下操作：

• 添加必要的依賴項
• 設置一個本地代理用於測試
• 配置 Worker 以符合 MCP 規範

💻 使用示例

基礎用法

更新你的 src/index.ts 文件以定義你的 MCP 服務器：

import { WorkerEntrypoint } from 'cloudflare:workers';
import { ProxyToSelf } from 'workers-mcp';

export default class MyWorker extends WorkerEntrypoint<Env> {
  /**
   * 一個友好的問候語，來自你的 MCP 服務器。
   * @param name {string} 用戶的名稱。
   * @return {string} 個性化的問候語。
   */
  sayHello(name: string) {
    return `你好，來自一個 MCP 工作者，${name}！`;
  }

  /**
   * @ignore
   */
  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

關鍵組件：

• WorkerEntrypoint：管理傳入請求和方法的暴露。
• ProxyToSelf：確保 MCP 協議符合性。
• sayHello 方法：AI 助手可以調用的一個示例 MCP 函數。

高級用法

你可以通過集成外部 API 來擴展你的 MCP 服務器。以下是獲取天氣數據的示例：

export default class WeatherWorker extends WorkerEntrypoint<Env> {
  /**
   * 獲取指定位置的天氣數據。
   * @param location {string} 城市或郵政編碼。
   * @return {object} 天氣詳情。
   */
  async getWeather(location: string) {
    const response = await fetch(`https://api.weather.example/v1/${location}`);
    const data = await response.json();
    return {
      temperature: data.temp,
      conditions: data.conditions,
      forecast: data.forecast
    };
  }

  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

🔧 技術細節

部署 MCP 服務器

完成代碼編寫後，你可以使用以下命令部署你的 MCP 服務器：

npm run dev

這將啟動一個開發環境下的 Worker。

測試

要測試你的 MCP 服務器，可以使用以下命令：

curl http://localhost:8787

根據你編寫的代碼，你可以獲得相應的響應。

安全措施

為了保護你的 MCP 服務器，建議採取以下安全措施：

1. 配置合適的 CORS 策略。
2. 使用環境變量存儲敏感信息。
3. 啟用速率限制以防止濫用。

通過以上步驟，你已經成功搭建了一個基於 Cloudflare Workers 的 MCP 服務器，並能夠集成外部 API 和進行基本的測試。