AI导哈

Cloudflare MCP 服务器

Cloudflare MCP 服务器是一个现代模型-上下文-协议（MCP）服务器，将Cloudflare的DNS、安全、重定向和区域设置功能暴露为结构化工具，供兼容的AI客户端（如Claude Desktop）调用。

  • by jeffgolden
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jeffgolden/cloudflare_mcp

使用说明

Cloudflare MCP服务器

现代模型上下文协议（MCP）服务器 云耀 结构化的DNS、安全、重定向和区域设置功能 工具 任何兼容的AI客户端（例如Claude Desktop）都可以调用它。

✨ 主要特点

  • 丰富的工具目录 –16个读写操作，涵盖DNS记录、WAF规则、页面规则重定向、缓存清除、区域设置等。
  • 即插即用Claude Desktop -配备STDIO运输工具，因此克劳德立即列出并调用工具；不需要额外的适配器。
  • 类型安全 –用TypeScript编写，由 @modelcontextprotocol/sdk，每个工具的参数和返回值都有zod模式。
  • 默认情况下为非破坏性 -破坏性证书订购功能被禁用，以防止意外成本。
  • 脚本库和测试 –手动操作和Jest集成/单元测试的一次性脚本。

🚀 快速开始

# 1. Clone & install
npm install

# 2. Configure credentials
cp config/.env.example .env
$EDITOR .env          # put your CLOUDFLARE_API_TOKEN

# 3. Build & run the server (stdio)
npm run build
node dist/index.js    # Claude Desktop will auto-detect

需要沙盒吗？ Cloudflare员工免费计划 允许您创建测试区。

🛠️ 工具目录

类别 工具名称 描述
概述 echo 连接测试的往返文本
区域 list_zones 枚举令牌可以访问的区域
区域 get_zone_settings 返回完整设置对象
区域 list_zone_settings 简短设置摘要
DNS list_dns_records 读取所有DNS RR集
DNS create_dns_record* 添加记录
DNS update_dns_record* 修改记录
DNS delete_dns_record* 删除记录
安全 list_waf_rules 读取防火墙规则
安全 create_security_rule* 添加防火墙规则
安全 update_security_rule* 编辑防火墙规则
安全 delete_security_rule* 删除防火墙规则
重定向 list_page_rules 列出重定向/页面规则
重定向 create_redirect* 创建重定向
重定向 delete_page_rule* 删除重定向
缓存 purge_cache* 清除URL或所有内容

*破坏性操作——小心使用。

SSL证书订购/上传功能是有意的 不 注册。通过移除中的过滤器来启用它们 src/index.ts 如果需要。

🧑‍💻 发展

# Watch-mode compile
npm run dev

# Run the full test suite
npm test

# Lint
npm run lint

方便的演示脚本 scripts/ （例如。 scripts/list-dns-demo.ts).全部接受a --zone 旗帜。

🏗️ 建筑

  • src/index.ts –入口点；合并工具映射并将其注册到 McpServer.
  • src/tools/ –单独的工具模块，每个导出 { tools, description }.
  • src/cloudflare-client.ts –围绕axios+CF API基本URL的精简包装。
  • tests/ Jest测试（单元+集成）。

服务器使用MCP SDK定义的JSON-RPC 2.0通过STDIO进行通信。看 docs/API.md.

🤝 贡献

欢迎PR和问题！请阅读 REFERENCE.md 用于编码约定和样式指南。

  1. Fork → 特性分支→ PR.
  2. 确保 npm test 通过。
  3. 清楚地描述工具行为或错误。

📜 许可证

麻省理工学院©2025杰夫·戈尔登

由Windsurf制成

相关 MCP