什么是 Cloudflare Worker MCP？
Cloudflare Worker MCP 是一个软件包，允许你将 Cloudflare Workers 连接到 MCP 客户端，例如 Claude Desktop。它将你的 TypeScript 或 JavaScript Worker 方法转换为可通过模型上下文协议调用的工具，供代理和 AI 应用使用，以执行逻辑、调用 API 和与在 Cloudflare 全球平台上运行的服务交互。
如何配置
- 使用
npx create-cloudflare@latest your-worker-name生成新的 Cloudflare Worker，并进入项目目录。 - 安装
workers-mcp包：npm install workers-mcp - 运行设置命令：
npx workers-mcp setup - 使用
npm run deploy在更改后部署你的 Worker，这将同时更新你的 Worker 和 MCP 的元数据。 - 如果与 Cursor 或自定义 MCP 代理集成，请配置你的
.json或项目配置，以使用合适的命令/参数字符串指向你的服务器。
如何使用
- 如常创建和部署你的 Cloudflare Worker。使用标准类方法从你的 Worker 导出函数（例如 API 端点或计算逻辑）。
- 安装并初始化
workers-mcp后，这些方法将作为 MCP 工具公开，便于客户端（如 Claude Desktop）发现和调用。 - 根据需要，运行本地 Node.js 代理服务器：
workers-mcp run ...，它将连接到已部署的 Worker，并为 MCP 客户端注册你的函数。 - 使用兼容客户端的内置 MCP 功能列出、调用并与暴露的 Worker 工具进行交互。
主要特性
- 无缝地将任何 Cloudflare Worker 函数作为 MCP 工具公开，允许 AI 代理进行远程过程调用。
- 自动将 Worker 方法签名（附带文档）翻译成 MCP 的工具接口。
- 实时更新：重新部署 Worker 代码以更新工具逻辑和元数据，无需额外配置。
- 支持 CLI 进行设置、运行本地代理和与各种兼容 MCP 的客户端集成。
- 支持本地和远程 Worker 连接，具有安全、可配置的设置。
用例
- 为 LLM 代理提供动态无服务器 API，例如生成随机数、数据获取或领域特定的应用逻辑。
- 启用自动化工作流程，让 Claude 或其他 AI 代理调用 Worker 函数以集成下游 API 或云服务。
- 构建具有现实效果的代理驱动应用程序，例如图像生成、数据处理或浏览器渲染。
- 快速原型设计新的 API 或函数，AI 编码工具能立即访问。
常见问题
Q1: 代码更改后需要重新部署吗？
是的，如果你修改了 Worker 的代码，请运行 npm run deploy 更新 Worker 实例及其功能元数据。如果你更改函数名、参数，或添加/删除方法，可能需要重新启动 MCP 客户端。
Q2: 如何从不同客户端连接到我的 Worker？
你可以使用 CLI 通过正确的命令连接，或通过在配置文件中指向你的 MCP 服务器条目来配置你的兼容 MCP 客户端（例如 Cursor、Claude Desktop 或自定义设置）。通常的命令是 /path/to/workers-mcp run <name> <worker-url> <project-path>。
Q3: 我可以在 Cloudflare Workers 上暴露任何函数或 API 吗？
是的，你可以暴露几乎任何函数，从简单的助手到与 Cloudflare 服务或外部 API 的高级集成。你的 Worker 方法会自动成为可调用的 MCP 工具。
Q4: 如何排查安装问题？
如果设置失败，请运行 npx workers-mcp help 获取诊断命令，并仔细检查 CLI 输出以获取配置提示。如果你怀疑存在配置问题，安全地重新运行 npx workers-mcp install:claude。