Workers MCP Server

Workers MCP Server

镜像

简介

Workers MCP 让你的 Cloudflare Workers 能够与 Claude Desktop 交互,实现通过 Model Context Protocol (MCP) 的扩展功能。

注意: 本项目已被 Workers MCP 包取代,请前往该仓库获取最新版本。

设置步骤

  1. 下载 Claude Desktop
  2. 克隆仓库并安装依赖:
    git clone <repo-url>
    cd <repo-dir>
    pnpm install
    
  3. 检查 wrangler.json(如未启用 Email Routing 或 Browser Rendering,请注释掉相关部分)
  4. 部署 Worker:
    pnpm deploy:worker
    
  5. 生成并上传密钥:
    npx workers-mcp secret generate
    npx workers-mcp secret upload
    
  6. 安装 MCP 服务器:
    npx workers-mcp install <server-alias> <worker-url>
    
  7. 重启 Claude Desktop

开发流程

编辑 src/index.ts 创建你的 MCP 服务:

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
    /**
     * 生成一个随机数
     * @return {string} 包含随机数的消息
     * */
    async getRandomNumber() {
        return `Your random number is ${Math.random()}`
    }
}

当你修改服务器代码后:

  1. 运行 pnpm deploy:worker 部署更新
  2. 添加/删除/修改方法时,需要重启 Claude Desktop

文档生成

使用 pnpm generate:docs:watch 可以实时查看 JSDoc 生成的文档变化。

工作原理

Workers MCP 由三部分组成:

  • 文档生成器:将 JSDoc 转换为 MCP 格式的工具描述
  • HTTP 处理程序:在 Worker 中提供 RPC 端点
  • 本地 MCP 代理:连接 Claude Desktop 与你的 Worker

完整的技术细节请查看 Workers MCP 仓库