Cloudflare MCP Server (Official)已精选

什么是 Cloudflare MCP Server (Official)？

Cloudflare MCP Server (Official) 是 Cloudflare 官方托管的 cloudflare mcp 端点，地址为 https://mcp.cloudflare.com/mcp。它通过少量 Code Mode 工具，让 AI 智能体访问整个 Cloudflare API（约 2,500 个端点）和开发者文档。

它不会为每个 API 端点注册一个工具，而是把 Cloudflare OpenAPI 规范保存在服务端，让智能体编写简短的 JavaScript 代码来搜索规范并调用 API。根据 cloudflare/mcp 的 README，这样工具定义只占约 1,100 个 token，而不是几十万个。该项目以 Apache-2.0 许可证开源，Cloudflare 文档称它是大多数用户唯一需要的 Cloudflare MCP 服务器。

如何使用 Cloudflare MCP Server (Official)？

前提条件：一个 Cloudflare 账号，以及支持远程（Streamable HTTP）服务器的 MCP 客户端。本地无需安装任何东西。

有两种认证方式：

• OAuth（推荐）： 连接该 URL 后会跳转到 Cloudflare，授权并选择要授予智能体的权限。
• API 令牌： 用于 CI/CD 或自动化。创建一个具备所需权限的 Cloudflare API 令牌，并在 Authorization 请求头中以 bearer 令牌形式发送。用户令牌和账户令牌均可使用；账户令牌需要加上 Account Resources : Read 权限，服务器才能自动识别账户 ID。启用了 Client IP Address Filtering 的令牌暂不支持。

Cloudflare 文档给出的通用配置：

{
  "mcpServers": {
    "cloudflare-api": {
      "url": "https://mcp.cloudflare.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http cloudflare https://mcp.cloudflare.com/mcp

然后在会话中运行 /mcp 完成 OAuth 登录。Cloudflare 还发布了一个 Claude Code 插件，把它的 MCP 服务器和技能打包在一起：/plugin marketplace add cloudflare/skills。

Cursor

把上面的 JSON 配置加入 Cursor 的 MCP 设置（mcp.json）。Cloudflare Skills 插件也可以从 Cursor Marketplace 安装。

VS Code

打开命令面板，运行 "MCP: Add Server"，选择 HTTP，然后输入 https://mcp.cloudflare.com/mcp。

Claude Desktop

把 https://mcp.cloudflare.com/mcp 添加为自定义连接器，或使用任何接受远程 MCP URL 的客户端。Cloudflare AI Playground 也可以直接填入服务器 URL。

可选 URL 参数

• ?codemode=false：为每个 API 端点单独注册一个工具（例如 get_workers_scripts），代替 Code Mode 工具。只有当客户端本身已经使用 code mode 时才需要，因为它会让成本升到约 244k token。
• ?truncateToolResult=false：关闭每个工具结果默认约 6,000 token 的上限。只有当客户端自己限制传给模型的内容时才使用。

Cloudflare MCP Server (Official) 的主要功能

• 官方出品，由 Cloudflare 托管，源码位于 cloudflare/mcp，Apache-2.0 许可
• 覆盖整个 Cloudflare API：Workers、KV、R2、D1、Pages、DNS、Firewall、Load Balancers、Stream、Images、AI Gateway、Vectorize、Access、Gateway 等
• Code Mode 设计：生成的代码通过 Dynamic Worker Loader API 在隔离的 Worker 中运行，只把结果返回给智能体
• 支持 OAuth（每次连接可选择权限），也支持用于自动化的 bearer API 令牌
• 通过同一个 execute 工具支持 Cloudflare GraphQL Analytics API
• 通过 MCP Skills 扩展提供 Cloudflare 技能（Wrangler、Durable Objects、Agents SDK、Workers 最佳实践）
• Streamable HTTP 端点为 /mcp；旧的 /sse URL 是同一处理程序的别名

Cloudflare MCP Server (Official) 工具

服务器只暴露一小组固定的工具：

• API 访问： search 针对 spec.paths 运行 JavaScript，找到合适的端点；execute 运行调用 cloudflare.request() 的 JavaScript，执行找到的端点。使用用户令牌时需要传入 account_id；使用账户令牌时会自动识别。
• 文档： docs 搜索 Cloudflare 开发者文档。
• 身份： whoami 返回当前连接所认证的用户或账户，方便客户端区分多个已连接的账户。

使用 ?codemode=false 时，docs 和 whoami 仍然保留，每个 API 端点则变成独立的工具。

Cloudflare MCP Server (Official) 的使用场景

• 盘点资源："列出我所有的 Workers 以及每个的最近部署时间。"
• 管理存储："创建一个名为 'my-cache' 的 KV 命名空间。"
• 编辑 DNS："为 api.example.com 添加一条指向 192.0.2.1 的 A 记录。"
• 拉取分析数据：通过 GraphQL Analytics API 查询 zone 流量，例如最近七天的请求数和缓存字节数。
• 构建 Worker 时，直接在编辑器里根据最新文档回答平台问题。
• 在 CI 流水线中使用限定权限的 API 令牌执行 Cloudflare 变更。

Cloudflare MCP Server (Official) 与替代方案对比

Cloudflare 运行两类 MCP 服务器。这个 API 服务器是需要广泛覆盖时的推荐选择。领域专用的 Cloudflare MCP 服务器（仓库 cloudflare/mcp-server-cloudflare）为单个产品领域提供精选的强类型工具，例如 Documentation（docs.mcp.cloudflare.com/mcp）、Browser Run（browser.mcp.cloudflare.com/mcp）和 Containers（containers.mcp.cloudflare.com/mcp）。其中一些较早的服务器，包括 Observability、Workers Bindings 和 Radar，已标记为弃用，并建议迁移到 mcp.cloudflare.com。

如果你想在 Workers 上构建并托管自己的 MCP 服务器，请参阅 Cloudflare 指南 Build a remote MCP server；这个 Cloudflare Workers MCP 模板 等社区模板也能实现同样的目的。

Cloudflare MCP Server (Official) 常见问题排查

• 账户令牌找不到你的账户： 添加 Account Resources : Read 权限，或显式传入 account_id。
• API 令牌被拒绝： 暂不支持启用了 Client IP Address Filtering 的令牌；请创建一个不带该过滤的令牌。
• 强制使用 SSE 的客户端连接失败： /sse 路径并不是旧的 HTTP+SSE 传输。请把客户端切换到 Streamable HTTP 或自动传输检测。
• 结果以 --- TRUNCATED --- 结尾： 每个结果上限约 6,000 token。请缩小查询范围；如果客户端会自行限制输出，可以使用 ?truncateToolResult=false。
• "Claude's response was interrupted"： Cloudflare 的 MCP 仓库指出，这通常是多次链式工具调用后达到了上下文上限；请让请求更具体，并拆分大型任务。