云运维#云计算#部署

Cloudflare MCP:用三个工具调用整个 Cloudflare API

Cloudflare 官方远程 MCP:Code Mode 用两个代码工具调用约 2500 个 API 端点,只占约千 token,另有日志等专用服务器。

项目与安装文档

查看项目

https://github.com/cloudflare/mcp-server-cloudflare

Cloudflare 的 OpenAPI 规范大约有 200 万 token,就算每个端点只保留必填参数做成 MCP 工具,也要 24 万 token,远超上下文窗口。Cloudflare 的做法是 Code Mode:规范留在服务器上,智能体写一小段 JavaScript 去搜索端点、再写一段去调用,返回的只是结果。这个推荐的服务器在 cloudflare/mcp 仓库,按产品划分的十几个专用服务器在 cloudflare/mcp-server-cloudflare,后者截至 2026-10-06 约 4400 star。

能做什么

  • Code Mode 全量 API:search 写 JavaScript 查询 spec.paths 找端点,execute 调用 cloudflare.request(),docs 搜开发者文档,覆盖 Workers、KV、R2、D1、Pages、DNS、防火墙等约 2500 个端点。
  • 可观测性:Observability 服务器查询 Workers 的日志和分析数据,Logpush 服务器汇总日志推送任务的健康状况。
  • 开发相关:Workers Bindings 服务器操作存储、AI 和计算原语,Workers Builds 服务器查看构建情况,Container 服务器拉起沙箱开发环境。
  • 其他专用服务器:Browser Run 抓网页转 Markdown 和截图,AI Gateway 查提示与响应日志,Radar 查互联网趋势,DNS Analytics 排查 DNS 性能。

适合谁

  • 在 Workers、R2、D1 上做开发,想让智能体直接查日志、建 KV 命名空间、改 DNS 记录的开发者。
  • 管理多个 Cloudflare 区域和安全规则、希望用自然语言排查问题的运维人员。

接入方式

全部是远程服务器,支持远程 MCP 的客户端直接填 URL。Code Mode 服务器用 OAuth 授权,连接时跳转到 Cloudflare 选择权限:

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

CI 等自动化场景可以改用 Cloudflare API Token 作为 Bearer Token。专用服务器的地址见 README 表格,例如可观测性是 https://observability.mcp.cloudflare.com/mcp。

编辑点评

Code Mode 是这个条目值得看的原因:用两个代码执行工具代替两千多个端点工具,上下文占用从几十万 token 降到一千左右,这个思路对其他大型 API 也有参考价值。专用服务器则适合只关心某一块产品、想要类型明确工具的场景。要注意它能真正改动你的账户,比如新增 DNS 记录、建 KV 命名空间,OAuth 授权时只勾选需要的权限;部分功能需要付费的 Workers 套餐。可观测性这类会连续调用多个工具的服务器容易把对话撑到上下文上限,README 建议把问题拆小。许可证为 Apache-2.0。