Cloudflare MCP Server

基本能力

产品定位

Cloudflare MCP Server 旨在通过自然语言接口简化 Cloudflare 平台上的资源管理和操作，提高开发者和运维人员的工作效率。

核心功能

• KV Store 管理：包括列出 KV 命名空间、获取/存储/删除 KV 值等功能。
• R2 Storage 管理：支持创建/删除 R2 存储桶，管理存储桶中的对象。
• D1 Database 管理：提供数据库的创建、删除和 SQL 查询功能。
• Workers 管理：支持 Worker 脚本的创建、更新、删除和获取。
• Durable Objects：管理 Durable Objects 命名空间和实例。
• Queues：支持队列的创建、删除和消息管理。
• Workers AI：提供 AI 模型的列表、详情查询和推理执行功能。
• Workflows：支持工作流的创建、更新和执行。
• Templates：管理 Worker 模板。
• Workers for Platforms：支持平台 Worker 的管理。
• Service Bindings：管理 Worker 的服务绑定。
• URL Routing：支持 URL 路由的管理。
• Cron Triggers：管理定时触发器。
• Zones & Domains：支持域名的管理。
• Secrets：管理 Worker 的密钥。
• Version Management：支持 Worker 版本的管理。
• Wrangler Config：管理 Wrangler 配置。
• Analytics：获取分析数据。

适用场景

• 通过自然语言指令快速部署和管理 Cloudflare Workers。
• 自动化管理 Cloudflare 上的存储和数据库资源。
• 使用 AI 模型进行内容生成和分析。
• 自动化工作流和任务调度。

工具列表

• get_kvs, kv_get, kv_put, kv_list, kv_delete：KV Store 管理工具。
• r2_list_buckets, r2_create_bucket, r2_delete_bucket, r2_list_objects, r2_get_object, r2_put_object, r2_delete_object：R2 Storage 管理工具。
• d1_list_databases, d1_create_database, d1_delete_database, d1_query：D1 Database 管理工具。
• worker_list, worker_get, worker_put, worker_delete：Workers 管理工具。
• durable_objects_list, durable_objects_create, durable_objects_delete, durable_objects_list_instances, durable_objects_get_instance, durable_objects_delete_instance：Durable Objects 管理工具。
• queues_list, queues_create, queues_delete, queues_get, queues_send_message, queues_get_messages, queues_update_consumer：Queues 管理工具。
• workers_ai_list_models, workers_ai_get_model, workers_ai_run_inference, workers_ai_list_tasks：Workers AI 管理工具。
• workflows_list, workflows_create, workflows_delete, workflows_get, workflows_update, workflows_execute：Workflows 管理工具。
• templates_list, templates_get, templates_create_from_template：Templates 管理工具。
• w4p_list_dispatchers, w4p_create_dispatcher, w4p_delete_dispatcher, w4p_get_dispatcher, w4p_update_dispatcher：Workers for Platforms 管理工具。
• bindings_list, bindings_create, bindings_update, bindings_delete：Service Bindings 管理工具。
• routing_list_routes, routing_create_route, routing_update_route, routing_delete_route：URL Routing 管理工具。
• cron_list, cron_create, cron_update, cron_delete：Cron Triggers 管理工具。
• zones_list, zones_create, zones_delete, zones_get, zones_check_activation：Zones & Domains 管理工具。
• secrets_list, secrets_put, secrets_delete：Secrets 管理工具。
• versions_list, versions_get, versions_rollback：Version Management 管理工具。
• wrangler_get_config, wrangler_update_config：Wrangler Config 管理工具。
• analytics_get：Analytics 管理工具。

常见问题解答

• 付费功能：部分功能（如分析和高级 D1 数据库功能）需要付费的 Cloudflare Workers 计划。
• 认证：如果未通过 Wrangler 认证，服务器会自动提示完成浏览器认证流程。

使用教程

使用依赖

• 确保已安装 Node.js 和 npm。

安装教程

1. 运行以下命令初始化服务器： bash npx @cloudflare/mcp-server-cloudflare init
2. 如果未通过 Wrangler 认证，服务器会自动提示完成浏览器认证流程。
3. 重启 Claude Desktop，可以看到可用的工具图标。

调试方式

1. 在项目文件夹中运行以下命令安装依赖并构建： bash pnpm install pnpm build:watch
2. 在另一个终端中运行以下命令启动服务器： bash node dist/index.js init
3. 使用 Vitest 运行测试： bash pnpm test bash pnpm test:coverage bash pnpm test -- tests/tools/queues.test.ts bash pnpm test:watch

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。