Cloudflare MCP API 服务器(企业版)

高性能模型上下文协议(MCP)服务器,为AI助手提供对Cloudflare生态系统的只读访问,支持通过自然语言查询整个Cloudflare基础设施。

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

使用说明

Cloudflare MCP API服务器(企业版)

一种高性能的模型上下文协议(MCP)服务器,为AI助手提供 只读访问 Cloudflare生态系统。通过Claude、Cursor或任何兼容MCP的客户端,使用自然语言查询您的整个Cloudflare基础设施。受启发于 mcp服务器cloudflare.

安全第一设计

该服务器为FedRAMP High环境实现了NIST 800-53 Rev.5控制:

控制 实施 文件
AU-12 (审核生成) 所有记录了敏感数据编校的API调用 src/audit-logger.ts
SC-5 (DoS保护) 令牌桶速率限制(100突发,10/sec) src/rate-limiter.ts
SI-10 (输入验证) Zod模式+GraphQL突变阻断 src/graphql-validator.ts
SI-11 (错误处理) 安全的错误消息,没有堆栈跟踪 src/api-client.ts
IA-5(7) (令牌保护) 内存中的XOR混淆 src/api-client.ts

为什么使用这个?

  • 基础设施发现:“我的所有区域都有哪些DNS记录?”
  • 安全审计:“哪些区域未启用WAF?”或“显示所有速率限制规则”
  • 故障排除:“example.com的SSL设置是什么?”
  • 文档:通过提问生成配置报告
  • 学习:探索您的Cloudflare设置,而无需记住API端点

特性

  • 354个只读工具 覆盖整个Cloudflare API表面(截至2026-02-05)
  • 零写入操作 -无法修改任何配置(使用安全)
  • 自然语言查询 -问问题,得到答案
  • 内置安全 -速率限制、审计日志记录、令牌保护

API覆盖范围

类别 示例
核心 帐户、区域、DNS、设置
安全 WAF、防火墙、Bot管理、页面屏蔽、DDoS
SSL/TLS 证书、通用SSL、自定义证书、mTLS
演出 Argo、缓存、负载平衡、候车室
零信任 访问应用程序、网关、设备、隧道、DEX
开发者平台 Workers、Pages、D1、R2、KV、队列、持久对象
分析 仪表板、GraphQL、审计日志
企业 Cloudforce One、Magic Transit、Spectrum、自定义主机名

快速开始

1.安装

git clone https://github.com/pocc/cloudflare-mcp.git
cd cloudflare-mcp
npm install
npm run build

2.创建API令牌

  1. 首选 Cloudflare仪表板→ API令牌
  2. 点击 创建令牌
  3. 使用 自定义令牌 随着 只读 权限:
    • 帐户设置:读取
    • 区域:阅读
    • 区域设置:读取
    • DNS:读取
    • SSL和证书:阅读
    • 防火墙服务:已读
    • 分析:阅读
    • 访问:应用程序和政策:阅读
    • 工作脚本:读取
    • 负载平衡器:阅读
    • (根据需要为您的用例添加更多内容)

3.配置您的MCP客户端

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cloudflare": {
      "command": "node",
      "args": ["/path/to/cloudflare-mcp/dist/index.js"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

游标/其他MCP客户端

CLOUDFLARE_API_TOKEN="your-token" node dist/index.js

查询示例

连接后,问自然语言问题:

发现

  • “列出我的所有区域及其状态”
  • “我部署了哪些工人?”
  • “显示所有Access应用程序”

安全审计

  • “哪些区域启用了机器人管理?”
  • “example.com上配置了哪些WAF规则?”
  • “列出我帐户中的所有利率限制规则”
  • “显示过去24小时的审核日志,按以下方式筛选user@example.com"

故障排除

  • “example.com的SSL设置是什么?”
  • “我的区域是否启用了Argo智能路由?”
  • “api.example.com有哪些DNS记录?”
  • “显示生产环境的负载平衡器配置”

零信任

  • “列出所有Cloudflare隧道连接”
  • “哪些访问策略保护我的应用程序?”
  • “显示网关网络策略”
  • “我的Zero Trust组织中注册了哪些设备?”

安全

特性 描述
只读 无法创建、更新或删除任何资源
速率限制 内置令牌桶(100次爆发,10/秒)
已记录审核 记录了所有API调用并对敏感数据进行了编辑
令牌受保护 API令牌在内存中被XOR模糊
输入已验证 Zod模式+GraphQL查询验证

最佳实践:

  • 创建令牌时使用最小特权原则
  • 从不将令牌提交到版本控制
  • 定期旋转令牌

文档

文档 描述
建筑 技术设计和数据流
API 参考 354个工具的完整列表
安全审查 FedRAMP合规性详细信息
安全修补程序 NIST控制实施

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院