Workers Mcp

将 Claude Desktop 与 Cloudflare Worker 连接起来进行交互

安装

npm install workers-mcp

快速开始

1. 创建 Worker

使用 Cloudflare 工具创建一个新 Worker:

npx create-cloudflare@latest

2. 创建 MCP Worker 类

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

  // 添加 fetch 处理器以处理请求
  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request)
  }
}

3. 配置部署脚本

在 package.json 中添加:

"scripts": {
  "deploy:worker": "workers-mcp docgen src/index.ts && wrangler deploy"
}

4. 生成密钥并部署

# 生成共享密钥
npx workers-mcp secret generate

# 部署 Worker
npm run deploy

# 上传密钥到 Worker
npx workers-mcp secret upload

5. 在 Claude 中安装

npx workers-mcp install <本地别名> https://<worker-name>.<your-name>.workers.dev

6. 启动 Claude Desktop

现在可以通过 Claude 调用你的 Worker 中的函数了。只需提示 Claude 执行相关操作即可。

迭代开发

更新 Worker 代码后运行 npm run deploy 即可更新。如果修改了方法名称、参数或新增/删除了方法，需要重启 Claude 以获取更新。

注意事项

• Worker 必须公开访问以便 Claude 能够连接
• 身份验证通过共享密钥实现
• 确保环境变量中包含 SHARED_SECRET

查看更多帮助:

npx workers-mcp help