workers-mcp

从 Claude 桌面端与 Cloudflare Worker 交互！

[!警告]
建议您先从这里开始 — 并构建一个远程MCP服务器

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

workers-mcp是什么？

此软件包提供 CLI 工具和 Worker 内部逻辑，用于将 Claude 桌面端（或任何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 开发者平台中的任何服务，暴露回编码代理、Claude 桌面端或其他 MCP 客户端中的 LLM。

_{是的，我知道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

要在 Cursor 中使你的 Cloudflare MCP 服务器正常工作，你需要将配置文件中的“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 持久对象