基本能力
产品定位
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 认证。
安装教程
- 运行以下命令初始化服务器：
bash
npx @cloudflare/mcp-server-cloudflare init - 如果未通过 Wrangler 认证，服务器会提示在浏览器中完成认证。
- 重启 Claude Desktop，可以看到可用的工具图标。
调试方式
- 在项目文件夹中运行以下命令以安装依赖并构建：
bash
pnpm install
pnpm build:watch - 在另一个终端中运行以下命令以启动本地服务器：
bash
node dist/index.js init - 使用
tools/list命令获取可用工具列表，然后使用tools/call命令调用具体工具。
测试
- 运行所有测试：
bash
pnpm test - 运行带覆盖率的测试：
bash
pnpm test:coverage - 运行特定测试文件：
bash
pnpm test -- tests/tools/queues.test.ts - 运行测试监视模式：
bash
pnpm test:watch
