Cloudflare MCP Server

基本能力

产品定位

mcp-server-cloudflare 是一个用于管理和操作 Cloudflare 服务的 MCP 服务器，通过自然语言指令简化 Cloudflare 资源的管理和部署。

核心功能

• KV 存储管理：包括列出 KV 命名空间、获取/存储/删除 KV 值等。
• R2 存储管理：包括列出 R2 桶、创建/删除桶、管理对象等。
• D1 数据库管理：包括列出数据库、创建/删除数据库、执行 SQL 查询等。
• Workers 管理：包括列出 Workers、获取/更新/删除 Worker 脚本等。
• Durable Objects 管理：包括列出命名空间、创建/删除命名空间、管理实例等。
• 队列管理：包括列出队列、创建/删除队列、发送/获取消息等。
• Workers AI：包括列出模型、运行推理等。
• 工作流管理：包括列出工作流、创建/删除工作流、执行工作流等。
• 模板管理：包括列出模板、从模板创建 Worker 等。
• 服务绑定管理：包括列出/创建/更新/删除服务绑定。
• URL 路由管理：包括列出/创建/更新/删除路由。
• Cron 触发器管理：包括列出/创建/更新/删除 Cron 触发器。
• 区域和域名管理：包括列出/创建/删除区域等。
• 密钥管理：包括列出/创建/删除密钥。
• 版本管理：包括列出版本、回滚版本等。
• Wrangler 配置管理：包括获取/更新 Wrangler 配置。
• 分析：包括获取分析数据等。

适用场景

• 通过自然语言指令快速部署和管理 Cloudflare Workers。
• 管理和操作 Cloudflare 的存储服务（KV、R2）。
• 查询和管理 Cloudflare D1 数据库。
• 自动化 Cloudflare 资源的创建和配置。
• 监控和分析 Cloudflare 服务的性能和数据。

工具列表

• get_kvs, kv_get, kv_put, kv_list, kv_delete：KV 存储管理工具。
• r2_list_buckets, r2_create_bucket, r2_delete_bucket, r2_list_objects, r2_get_object, r2_put_object, r2_delete_object：R2 存储管理工具。
• d1_list_databases, d1_create_database, d1_delete_database, d1_query：D1 数据库管理工具。
• 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：队列管理工具。
• 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：工作流管理工具。
• templates_list, templates_get, templates_create_from_template：模板管理工具。
• 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：服务绑定管理工具。
• routing_list_routes, routing_create_route, routing_update_route, routing_delete_route：URL 路由管理工具。
• cron_list, cron_create, cron_update, cron_delete：Cron 触发器管理工具。
• zones_list, zones_create, zones_delete, zones_get, zones_check_activation：区域和域名管理工具。
• secrets_list, secrets_put, secrets_delete：密钥管理工具。
• versions_list, versions_get, versions_rollback：版本管理工具。
• wrangler_get_config, wrangler_update_config：Wrangler 配置管理工具。
• analytics_get：分析工具。

常见问题解答

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

使用教程

使用依赖

• 需要安装 Node.js 和 npm。
• 需要 Cloudflare 账户并通过 Wrangler 认证。

安装教程

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. 使用 tools/list 命令获取可用工具列表，然后使用 tools/call 命令调用具体工具。

测试

• 运行所有测试： 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 了解完整条款。