Mcp Server Cloudflare

面向 AI 助手的 MCP Server Cloudflare — Workers、KV、R2、DNS 和缓存

一个 MCP 服务，可让你的 AI 助手管理 Cloudflare Workers、KV、R2、DNS 和缓存清理。Vercel、Railway 和 Netlify 都有 MCP 服务了——现在 Cloudflare 也有了。

You: "List my Workers and purge cache for example.com"
AI:  Found 3 Workers: api-gateway, auth-worker, image-resizer
     ✅ Cache purged for https://example.com

适用于 Claude Desktop、Cursor 和 VS Code Copilot。

工具

工具	功能
cf_zones	列出你的 Cloudflare 区域（域名）
cf_dns_list	列出某个区域的 DNS 记录
cf_dns_create	创建 DNS 记录
cf_dns_delete	删除 DNS 记录
cf_workers_list	列出 Workers 脚本
cf_worker_delete	删除 Workers 脚本
cf_kv_namespaces	列出 KV 命名空间
cf_kv_keys	列出 KV 命名空间中的键
cf_kv_get	获取 KV 中的值
cf_kv_put	将值写入 KV
cf_kv_delete	删除 KV 键
cf_r2_buckets	列出 R2 存储桶
cf_cache_purge	清理缓存（全部或指定 URL）

快速开始

使用 Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "mcp-server-cloudflare-dns"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your_api_token",
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

使用 Cursor

添加到你的 .cursor/mcp.json：

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "mcp-server-cloudflare-dns"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your_api_token",
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

身份验证

1. 前往 Cloudflare 控制面板 > API 令牌
2. 创建具有所需权限的令牌：
   • Zone:Read — 用于列出区域和 DNS
   • Zone:Edit — 用于创建/删除 DNS 记录
   • Workers Scripts:Edit — 用于管理 Workers
   • Workers KV Storage:Edit — 用于 KV 操作
   • Zone:Cache Purge — 用于清理缓存
3. 设置 CLOUDFLARE_API_TOKEN 环境变量
4. 为 Workers、KV 和 R2 操作设置 CLOUDFLARE_ACCOUNT_ID

示例

向你的 AI 助手提问：

• “列出我的 Cloudflare 区域”
• “显示区域 xyz 的 DNS 记录”
• “创建一个指向 1.2.3.4 的 A 记录”
• “列出我的 Workers”
• “显示命名空间 abc 中的 KV 键”
• “清理 https://example.com/page 的缓存”
• “列出我的 R2 存储桶”

Agent Plugins

此仓库是一个 Agent Plugins 1.0.0 软件包：plugin.json、可移植的 mcp.json 和 skills/ 与 MCP 服务一同打包。

对于 Cursor，克隆此仓库并将其复制或符号链接到 ~/.cursor/plugins/local/mcp-server-cloudflare，然后重新加载窗口。Skills 和 MCP 会显示在 Customize > Plugins 下。

Agent Plugins v1 不提供 OAuth。请在 MCP 客户端环境中设置 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID（参见“快速开始”）。由于凭据保留在环境变量中，因此不提供一键安装。

通过 npm 软件包 mcp-server-cloudflare-dns 安装并运行（不要使用 npm 上无关的 mcp-server-cloudflare 占位包）。

常见问题

我应该安装哪个 npm 软件包？

使用 npx -y mcp-server-cloudflare-dns。该仓库在 GitHub 上名为 mcp-server-cloudflare；在 npm 上发布的名称是 mcp-server-cloudflare-dns。

需要哪些环境变量？

所有 API 调用都需要 CLOUDFLARE_API_TOKEN。Workers、KV 和 R2 工具需要 CLOUDFLARE_ACCOUNT_ID。

我可以将其安装为 Cursor 中的 Agent 插件吗？

可以，通过 ~/.cursor/plugins/local/mcp-server-cloudflare 安装。在 Cursor 的 MCP 设置中配置相同的环境变量。

这个 MCP 可以管理什么？

区域和 DNS、Workers 脚本、KV 命名空间、R2 存储桶列表，以及清除某个区域的缓存。

为什么没有 Cursor 一键安装按钮？

API 令牌和账户 ID 无法嵌入可移植的安装链接。请使用快速入门中的 JSON。

开发

npm install
npm test
npm run build

作者

---

_{此 README 使用 README Builder 构建}

许可证

MIT © Ofer Shapira