AI导哈

Worker MCP连接工具

提供CLI工具和Worker逻辑，将Claude Desktop或其他MCP客户端连接到Cloudflare Worker，支持自定义功能并暴露给本地MCP客户端使用。

  • by cloudflare
  • TypeScript
  • 本地部署
  • 647 星标
  • 更新于
在 GitHub 查看 cloudflare/workers-mcp

使用说明

workers-mcp

与Claude Desktop的Cloudflare员工交谈！

[！警告]
你应该开始了 这里 相反，并构建一个 远程 MCP服务器

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

是什么 workers-mcp?

此软件包提供CLI工具和in-Worker逻辑，用于连接Claude Desktop（或任何 MCP客户端)将Cloudflare Worker添加到您的帐户上，以便您可以对其进行自定义以满足您的需求。它通过一个构建步骤工作，可以像这样翻译Worker的TypeScript方法：

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
  /**
   * Generates a random number. This is extra random because it had to travel all the way to
   * your nearest Cloudflare PoP to be calculated which... something something lava lamps?
   *
   * @return {string} A message containing a super duper random number
   * */
  async getRandomNumber() {
    return `Your random number is ${Math.random()}`
  }
  
  // ...etc
}

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

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

用法

步骤1：生成新Worker

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

npx create-cloudflare@latest my-new-worker

我建议选择一个 Hello World 工人。

步骤2：安装 workers-mcp

cd my-new-worker # I always forget this bit
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客户端一起使用

光标

要使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图像生成模型。克劳德真的很擅长提出提示，并且可以解释结果，并决定哪些新的提示来实现你想要的结果。
  • TODO浏览器渲染
  • TODO耐用对象

相关 MCP