使用说明
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令牌
- 首选 Cloudflare仪表板→ API令牌
- 点击 创建令牌
- 使用 自定义令牌 随着 只读 权限:
- 帐户设置:读取
- 区域:阅读
- 区域设置:读取
- 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 作为指导方针。
许可证
麻省理工学院