workers-mcp

从 Claude Desktop 连接到 Cloudflare Worker！

[!WARNING] 你应该从这里开始 —— 并构建一个远程 MCP 服务器

你可以使用 mcp-remote 从 Claude Desktop、Cursor 和其他客户端连接到远程 MCP 服务器。

什么是 workers-mcp？

这个包提供了 CLI 工具和 Worker 内部逻辑，用于将 Claude Desktop（或任何 MCP 客户端）连接到你账户上的 Cloudflare Worker，以便你可以根据自己的需求进行定制。它通过一个构建步骤工作，可以将你的 Worker 的 TypeScript 方法转换成这样：

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
  /**
   * 生成一个随机数。这个随机数非常随机，因为它必须一路跑到
   * 你最近的 Cloudflare PoP 才能被计算出来，这... 就像熔岩灯一样？
   *
   * @return {string} 包含一个超级随机数的消息
   * */
  async getRandomNumber() {
    return `Your random number is ${Math.random()}`
  }
  
  // ...等等
}

...转换成 MCP 工具，本地 Node.js 服务器可以将其暴露给 MCP 客户端。Node.js 服务器充当代理，在本地处理 stdio 传输，并调用在 Cloudflare 上运行的 Worker 的相关方法。这允许你暴露你的应用程序中的任何函数或 API，或者 Cloudflare 开发者平台 中的任何服务，返回给你的编码代理中的 LLM、Claude Desktop 或其他 MCP 客户端。

_{是的，我知道 Math.random() 在 Worker 上的工作方式与在你的本地机器上相同，但不要告诉 Claude} 🤫

用法

步骤 1：生成一个新的 Worker

使用 create-cloudflare 生成一个新的 Worker。

npx create-cloudflare@latest my-new-worker

我建议选择一个 Hello World worker。

步骤 2：安装 workers-mcp

cd my-new-worker # 我总是忘记这一步
npm install workers-mcp

步骤 3：运行 setup 命令

npx workers-mcp setup

注意：如果出现问题，运行 npx workers-mcp help

步骤 4..♾️：迭代

在更改你的 Worker 代码后，你只需要运行 npm run deploy 来更新 Claude 关于你的函数的元数据和你正在运行的 Worker 实例。

但是，如果你更改了你的方法的名称，或者它们的参数，或者添加或删除了方法，Claude 将不会看到更新，直到你重新启动它。

你永远不需要重新运行 npx workers-mcp install:claude，但如果你想排除 Claude 配置作为错误的来源，这样做是安全的。

与其他 MCP 客户端一起使用

Cursor

要使你的 Cloudflare MCP 服务器在 Cursor 中工作，你需要将配置文件中的“command”和“args”组合成一个字符串，并使用类型“command”。

例如，如果你的配置文件如下所示：

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

在 Cursor 中，创建一个 MCP 服务器条目，其中：

• 类型：command
• 命令：/path/to/workers-mcp run your-mcp-server-name https://your-server-url.workers.dev /path/to/your/project

其他 MCP 客户端

对于 Windsurf 和其他 MCP 客户端，更新你的配置文件以包含你的 worker，这样你就可以直接从客户端使用这些工具：

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

请确保将占位符替换为你实际的服务器名称、URL 和项目路径。

示例

请参阅 examples 目录，了解一些使用此功能的想法：

• examples/01-hello-world 是在上述安装说明之后拍摄的快照
• examples/02-image-generation 使用 Workers AI 运行 Flux 图像生成模型。Claude 非常擅长提出提示，并且可以实际解释结果并决定尝试哪些新提示来实现你想要的结果。
• TODO 浏览器渲染
• TODO Durable Objects