Cloudflare MCP 服务器：通过自然语言管理 Cloudflare 资源的全能工具

Cloudflare MCP 服务器是基于模型上下文协议（MCP）的工具，允许通过 Claude Desktop 等 MCP 客户端使用自然语言操作 Cloudflare 账户，实现资源管理自动化。以下是核心功能与使用指南：

一、核心功能概览

通过自然语言指令直接调用 Cloudflare API，支持以下资源管理场景：

1. KV 存储管理

• get_kvs：列出账户下所有 KV 命名空间
• kv_get/kv_put/kv_list/kv_delete：获取、存储、列出、删除 KV 键值对

2. R2 存储管理

• r2_list_buckets：列出所有 R2 存储桶
• r2_create_bucket/r2_delete_bucket：创建/删除存储桶
• r2_put_object/r2_get_object：上传/下载对象

3. D1 数据库管理

• d1_list_databases：列出所有 D1 数据库
• d1_query：执行 SQL 查询（如 SELECT * FROM users LIMIT 10）
• d1_create_database/d1_delete_database：创建/删除数据库

4. Workers 开发平台

• worker_list/worker_get：列出/获取 Worker 脚本
• worker_put：部署或更新 Worker 脚本
• templates_create_from_template：基于官方模板快速创建 Worker

5. 高级功能

• Durable Objects：管理持久化对象命名空间及实例
• Queues：创建队列、发送/获取消息
• Workers AI：调用 AI 模型执行推理任务（如文本生成、图像分析）
• Analytics：获取域名分析数据（请求量、带宽、威胁等，需付费套餐）

二、快速上手步骤

1. 环境准备

• 安装 Wrangler：Cloudflare 官方 CLI 工具，用于认证和资源管理

                      
  bash
  
                      npm install -g @cloudflare/wrangler  
  

• 登录 Cloudflare：

                      
  bash
  
                      npx wrangler login  
  

  （完成认证后，MCP 服务器可本地访问 Cloudflare 资源）

2. 启动 MCP 服务器

                    
bash

                    npx @cloudflare/mcp-server-cloudflare init  

• 启动后，重启 Claude Desktop 或其他 MCP 客户端，显示工具图标及可用命令列表。

3. 示例指令

自然语言请求	对应工具与操作
"创建一个名为 'my-worker' 的 Worker 脚本"	worker_put + 脚本内容
"将 KV 命名空间 'my-kv' 中的 'key1' 值更新为 'value1'"	kv_put(namespace="my-kv", key="key1", value="value1")
"查询 D1 数据库 'mydb' 中的用户表数据"	d1_query(database="mydb", query="SELECT * FROM users")
"在 R2 存储桶 'my-bucket' 中上传文件 'image.jpg'"	r2_put_object(bucket="my-bucket", path="image.jpg")

三、付费功能说明

部分高级功能需 Cloudflare 付费套餐：

• Analytics 数据：analytics_get 需 Workers 付费计划
• D1 高级功能：如高并发查询、跨区域复制
• Workers AI 模型：部分大模型调用需按量付费
• 资源配额：免费套餐有 KV/R2 操作次数限制

四、工具列表与参数参考

工具分类	工具名称	核心参数	功能描述
KV 存储	kv_put	namespace, key, value	存储 KV 键值对
R2 存储	r2_list_objects	bucket, prefix, limit	列出存储桶中的对象
D1 数据库	d1_query	database, query	执行 SQL 查询
Workers	worker_list	--all（可选）	列出所有 Worker 脚本
Durable Objects	durable_objects_create	namespace_name, script_name	创建持久化对象命名空间
AI 功能	workers_ai_run_inference	model, input_data	使用 Workers AI 模型执行推理

五、最佳实践场景

1. 开发者效率提升

   • 通过自然语言快速部署 Worker 脚本，替代手动编写代码和配置
   • 示例："用 Durable Objects 模板创建一个计数器应用"

2. 运维自动化

   • 定期备份 KV 数据到 R2 存储桶："每周自动将 'kv-backup' 命名空间同步到 'r2-backup-bucket'"
   • 批量删除过期的 D1 数据库记录："删除 'logs' 数据库中创建时间早于 30 天的记录"

3. 数据分析与监控

   • 获取指定域名的威胁分析数据："查看 'example.com' 上周的 DDoS 攻击次数"
   • 生成 Workers 运行状态报告："统计 'my-worker' 过去 24 小时的错误率"

六、注意事项

• 权限控制：MCP 服务器使用 Wrangler 认证，确保账户权限与操作匹配（如仅允许特定 IP 访问）
• 数据安全：敏感操作（如删除资源）建议在指令中明确确认参数（如 --force 标志）
• 版本兼容：定期更新 MCP 服务器版本，确保与 Cloudflare API 变动同步

通过 Cloudflare MCP 服务器，开发者和运维人员可将日常资源管理任务转化为自然语言对话，大幅降低操作门槛，尤其适合多云环境下的自动化流程构建。如需深度定制，可参考 官方文档 扩展工具功能。