Cloudflare Workers

🚀 workers-mcp

workers-mcp 是一個強大的工具包，它藉助 Cloudflare Worker 實現與 Claude Desktop 的對話交互。通過它，你能將應用程序中的各類函數、API 或 Cloudflare 開發者平臺的服務，重新提供給 LLM、Claude Desktop 或其他 MCP 客戶端，滿足多樣化的使用需求。

🚀 快速開始

安裝步驟

要開始使用 workers-mcp，請按照以下步驟進行操作：

1. 使用 npx create-cloudflare@latest my-new-worker 生成新的 Worker 項目。
2. 進入項目目錄並運行 npm install workers-mcp 來安裝所需的依賴項。
3. 運行 npx workers-mcp setup 設置 MCP 配置。如果出現問題，請參考幫助信息進行調試。

使用說明

每次修改 Worker 代碼後，只需運行 npm run deploy 即可更新 Claude 的元數據和實際的 Worker 實例。

其他客戶端配置

對於 Cursor 等其他客戶端，需將命令與參數合併為字符串，並指定類型為 command。確保路徑和參數正確無誤以避免連接問題。

示例項目

• examples/01-hello-world 展示了安裝後的初始狀態。
• examples/02-image-generation 使用 Workers AI 運行圖像生成模型，Claude 可以根據效果調整提示詞。

✨ 主要特性

• 此包提供了 CLI 工具和在 Worker 中運行的邏輯，可將 Claude Desktop（或其他 MCP 客戶端）連接到您賬戶中的 Cloudflare Worker，實現自定義配置。
• 通過構建步驟，能將 TypeScript 方法轉換為 MCP 工具，供本地 Node.js 服務器將這些工具暴露給 MCP 客戶端。
• Node.js 服務器作為代理，處理本地的 stdio 運輸，並調用您在 Cloudflare 上運行的 Worker 中的相關方法。

💻 使用示例

基礎用法

以下是一個將 TypeScript 方法轉換為 MCP 工具的示例代碼：

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
  /**
   * 生成一個隨機數。由於該數字必須經過 Cloudflare 最近的 POP 才能計算，因此此數字是額外隨機的... lava 燈的某些事情。
   *
   * @return {string} 包含超級隨機數字的消息
   * */
  async getRandomNumber() {
    return `Your random number is ${Math.random()}`
  }
  
  // ...等等
}

📚 詳細文檔

什麼是 workers-mcp？

此包提供了 CLI 工具和在 Worker 中運行的邏輯，以便將 Claude Desktop（或其他 MCP 客戶端）連接到您賬戶中的 Cloudflare Worker。這樣可以自定義以滿足您的需求。它通過構建步驟將 TypeScript 方法轉換為 MCP 工具，供本地 Node.js 服務器將這些工具暴露給 MCP 客戶端。Node.js 服務器作為代理，處理本地的 stdio 運輸，並調用您在 Cloudflare 上運行的 Worker 中的相關方法。這樣，您可以將應用程序中的任何函數或 API，或 Cloudflare 開發者平臺 中的任何服務，重新提供給 LLM、Claude Desktop 或其他 MCP 客戶端。

注意事項

⚠️ 重要提示

您應該從這裡開始，而不是構建一個遠程 MCP 服務器。您可以使用 mcp-remote 從 Claude Desktop、Cursor 和其他客戶端連接到您賬戶的遠程 MCP 服務器 此處。

⚠️ 重要提示

在這裡，我們注意到隨機數生成實際上並不是隨機的，因為所有調用都會返回相同的值。這是一個已知問題。

💡 使用建議

文檔建議使用遠程 MCP 服務器而非本地代理，可能在穩定性和性能上表現更優。進一步瞭解遠程配置的具體步驟和優勢，有助於優化您的設置。在實際操作中可能會遇到路徑錯誤、權限問題或連接超時，請參考文檔中的故障排除部分解決問題。