SuperAPI AI 工具集

cloudflare

部署与运维

查看项目

更新于 10-21 12:51

技能介绍

Cloudflare Operations 技能用于通过 Cloudflare 托管的 API MCP 执行 Cloudflare 生产环境运维。默认以只读调查为主,权限边界由 Cloudflare OAuth 或 API 令牌范围决定,该插件无法在 MCP 内对单个 Cloudflare API 操作进行白名单控制。

MCP 基础 Cloudflare MCP 暴露三个工具:docs 用于搜索 Cloudflare 开发者文档,了解产品行为和术语;search 用于查看当前 Cloudflare API 规范;execute 用于以极简 JavaScript 调用 Cloudflare API。当 Cloudflare 产品行为不明确时使用 docs;每次 execute 前先使用 search,规范是当前方法、路径、参数和响应结构的唯一依据。除非用户明确批准变更状态的改动,execute 调用应保持小范围、限定作用域且只读。

参考文档加载 根据请求有条件地加载参考文档:涉及 Worker 错误、失败构建、日志、Logpush、DNS 检查、负载均衡健康、隧道时,读取 references/workflows.md;涉及任何变更状态的请求(部署、回滚、DNS、WAF、负载均衡、Access、Logpush、存储、账户成员)时,读取 references/safety-and-permissions.md;遇到认证失败、权限错误、多账户/多区域、速率限制、过期操作时,读取 references/troubleshooting-workarounds.md。

工作流程

  1. 将请求分类为只读调查或变更状态的工作。
  2. 解析目标作用域:用户明确指定的账户/区域/资源优先;否则在相关场景使用 cloudflare.account.id、cloudflare.zone.id 和 cloudflare.worker.name 配置;否则通过 MCP 发现,若有歧义则提出一个聚焦问题。
  3. 任何 Cloudflare API 调用前,先搜索 MCP API 规范。不要凭记忆或捆绑文档调用 Cloudflare API 路径。
  4. 保持调查范围有限:"现在"类问题查看最近 30 分钟,回顾性检查查看最近 24 小时,构建/部署查看最近 N 次,除非用户要求更多。
  5. 任何变更状态的 API 调用前,加载 references/safety-and-permissions.md,展示当前状态和预期变更,然后等待明确批准。
  6. 先给出具体发现,再给出证据。有 ID 时附上仪表板链接。

护栏 只读优先:默认调查。不要响应"修复这个"或"回滚它"等模糊请求执行写入,应先调查并提出计划。 搜索决定 API 选择:捆绑参考提供工作流,而非 API 权威。 尊重渠道默认值:当请求提到"the Worker"、"our Worker"、部署、构建、日志或 Worker 错误但未指明 Worker 时,若已配置 cloudflare.worker.name,则将其作为默认 Worker 目标。 写入前确认:在展示当前状态和变更摘要并获得用户明确批准前,不得进行 Worker 部署、回滚、DNS 创建/更新/删除、负载均衡变更、WAF 规则变更、Access 策略变更或 R2/KV/D1 破坏性操作。 默认绝不删除数据:对 R2、KV 和 D1,支持列出/检查/读取。除非用户明确要求并确认,避免删除/截断/丢弃。 脱敏敏感数据:不要粘贴原始日志正文、Worker 源码、环境变量值、令牌值或授权头。 认证失败即停止:如果 MCP 服务器返回认证错误,停止并告知用户。不要猜测缺失的权限。 禁止范围蔓延:仅操作用户指定的账户/区域/资源。不要枚举或修改其他账户或区域中的资源。