Workers MCP Demo

🚀 雲flare 工作者 MCP 演示

這是一個藉助 Cloudflare Workers MCP 創建自定義 AI 工具的簡易演示項目。這些工具可與 Claude、Cursor 以及其他支持 MCP 的 AI 助手協同使用，為 AI 應用帶來更多可能性。

🚀 快速開始

本項目利用 Cloudflare Workers MCP 創建自定義工具，這些工具能被 AI 助手訪問和使用，從而擴展 AI 的能力。以下是快速開始的步驟：

1. 克隆此倉庫

git clone https://github.com/akazwz/workers-mcp-demo.git
cd workers-mcp-demo

2. 安裝依賴

pnpm install

3. 配置你的 Cloudflare Worker 確保你已經通過 Wrangler 登錄到 Cloudflare：

pnpx wrangler login

然後運行 MCP 設置命令：

npx workers-mcp setup

這將自動配置你的 Worker 以支持 MCP。 4. 部署你的 Worker

pnpm run deploy

5. 配置你的 MCP 客戶端
   • 對於 Claude Desktop： 運行以下命令在 Claude 中安裝你的 MCP 服務器：

pnpx workers-mcp install:claude

- 對於 Cursor：

在 Cursor 的 MCP 配置中添加以下內容：

{
  "type": "command",
  "command": "/path/to/workers-mcp run workers-mcp-demo https://your-worker-url.workers.dev /path/to/workers-mcp-demo"
}

✨ 主要特性

• 自定義 AI 工具：在 Cloudflare Workers 上運行的自定義 AI 工具，為 AI 應用提供個性化功能。
• 無縫集成：與 Claude、Cursor 和其他 MCP 客戶端實現無縫集成，提升使用體驗。
• 能力擴展：能夠通過自己的無服務器函數擴展 AI 能力，滿足多樣化需求。

📦 安裝指南

前提條件

• Node.js (v16 或更高版本)
• pnpm 包管理器
• Cloudflare 賬戶
• Wrangler CLI
• Claude Desktop、Cursor 或其他支持 MCP 的客戶端

安裝步驟

1. 克隆此倉庫

git clone https://github.com/akazwz/workers-mcp-demo.git
cd workers-mcp-demo

2. 安裝依賴

pnpm install

3. 配置你的 Cloudflare Worker

確保你已經通過 Wrangler 登錄到 Cloudflare：

pnpx wrangler login

然後運行 MCP 設置命令：

npx workers-mcp setup

這將自動配置你的 Worker 以支持 MCP。

免費用戶配置注意事項

⚠️ 重要提示

如果你是 Cloudflare Workers 的免費用戶（非付費用戶），需要修改 wrangler.jsonc 文件，刪除或註釋掉以下配置：

"browser": {
  "binding": "BROWSER"
}

這是因為 Browser Rendering API 僅適用於付費用戶。刪除此配置後，screenshotURL 和 extractImagesFromURL 功能將無法使用，但其他功能仍然可以正常工作。

4. 部署你的 Worker

pnpm run deploy

5. 配置你的 MCP 客戶端

對於 Claude Desktop

運行以下命令在 Claude 中安裝你的 MCP 服務器：

pnpx workers-mcp install:claude

對於 Cursor

在 Cursor 的 MCP 配置中添加以下內容：

{
  "type": "command",
  "command": "/path/to/workers-mcp run workers-mcp-demo https://your-worker-url.workers.dev /path/to/workers-mcp-demo"
}

💻 使用示例

基礎用法

配置完成後，你可以直接從 AI 助手使用你的自定義 MCP 工具。例如，在 Claude Desktop 中，你可以使用如下命令：

@workers-mcp-demo getRandomNumber

📚 詳細文檔

什麼是 MCP？

MCP (Model Context Protocol) 是由 Anthropic 開源的一個標準，用於連接 AI 助手與數據源，包括內容倉庫、業務工具和開發環境。它的目標是幫助前沿模型生成更好、更相關的回應。

可用工具

此演示包括以下工具：

• getRandomNumber：生成一個隨機數
• generateImage：根據文本提示創建圖像
• screenshotURL：對指定 URL 進行截圖（需要付費賬戶）
• extractImagesFromURL：從網頁中提取圖像（需要付費賬戶）

自定義

要添加自己的工具，編輯 src/index.ts 文件並向 Worker 類添加新方法。更改後，使用以下命令重新部署你的 Worker：

pnpm run deploy

故障排除

• 如果你的 AI 助手看不到你的工具，嘗試重啟助手。
• 如果你更改了方法名稱或參數，你需要重啟 AI 助手才能使更改生效。
• 檢查 Cloudflare Workers 日誌以查看部署中的任何錯誤。
• 如果使用免費賬戶時出現 Error: Browser Rendering API is only available for Workers Paid plans 錯誤，請參考上面的免費用戶配置注意事項。

📄 許可證

本項目採用 MIT 許可證。

致謝

• Cloudflare Workers MCP 提供底層框架
• Anthropic Model Context Protocol 開源的 MCP 標準
• Cloudflare Workers 提供無服務器平臺