项目简介
Cloudflare API MCP Server 是一个基于 Model Context Protocol (MCP) 构建的轻量级服务器,部署在 Cloudflare Workers 平台上。它旨在为 LLM 客户端(如 Cursor)提供与 Cloudflare REST API 交互的能力,通过一系列预置的 工具 (Tools),用户可以使用自然语言指令,间接管理和操作 Cloudflare 的各项服务。
主要功能点
-
资源管理 (通过工具访问): 提供对多种 Cloudflare 资源的访问和管理能力,包括:
- DNS管理: 创建、删除、编辑、列出 DNS 记录,以及列出 Zone 信息。
- KV存储管理: 创建、更新、删除 KV 命名空间和键值对,批量操作,获取元数据。
- R2对象存储管理: 创建、获取、列出 R2 存储桶,管理 CORS 配置。
- Worker管理: 管理 Worker 域名、Cron 触发器、Workflow 等。
- 队列管理: 创建、获取、列出队列,消息的确认和拉取。
- Hyperdrive 配置管理: 创建、编辑、删除、获取和列出 Hyperdrive 配置。
- 缓存管理: 清除 Cloudflare 缓存。
-
工具 (Tools) 注册和执行: 将 Cloudflare API 的各项操作封装为 MCP 工具 (Tools),LLM 客户端可以通过调用这些工具来执行相应的 Cloudflare 操作。每个工具都配有清晰的描述和参数定义,方便 LLM 理解和调用。
-
易于部署和使用: 基于 Cloudflare Workers 部署,serverless 架构,易于安装和配置。提供了自动化安装脚本和详细的使用说明。
安装步骤
-
克隆并部署 MCP 服务器: 运行以下命令,自动化克隆仓库并部署到您的 Cloudflare 账户:
bun create mcp --clone https://github.com/zueai/cloudflare-api-mcp按照脚本提示完成部署。
-
配置 MCP 服务器到客户端: 打开您的 MCP 客户端(例如 Cursor),在设置中找到 MCP 服务器配置,点击 "Add new MCP server"。
-
上传 Cloudflare API 密钥和邮箱: 使用 Wrangler CLI 工具,将您的 Cloudflare API 密钥和邮箱上传到 Worker secrets 中:
bunx wrangler secret put CLOUDFLARE_API_KEY bunx wrangler secret put CLOUDFLARE_API_EMAIL
服务器配置
以下 JSON 配置信息用于 MCP 客户端连接 Cloudflare API MCP Server。您需要将此配置添加到您的 MCP 客户端中。
{ "server name": "Cloudflare API MCP Server", "command": "Cloudflare API MCP Server", "args": [] }
配置参数说明:
- 'server name': MCP 服务器的名称,您可以自定义。
- 'command': MCP 服务器的启动命令,对于 Cloudflare Workers 部署的 MCP 服务器,此处填写服务器的名称即可,客户端会通过 Cloudflare Workers 的 URL 进行连接。
- 'args': 启动参数,此服务器无需额外启动参数,保持为空数组 '[]' 即可。
基本使用方法
-
启动 MCP 客户端: 启动您配置了 Cloudflare API MCP Server 的 MCP 客户端(如 Cursor)。
-
使用自然语言指令调用工具: 在客户端中,您可以使用自然语言指令,结合工具名称和参数来执行 Cloudflare 操作。例如,在 Cursor 中,您可以输入类似 'Create a DNS record for example.com with name 'test' and content '192.0.2.1' of type 'A'' 的指令。客户端会自动识别指令中的意图,调用相应的 MCP 工具,并将参数传递给 Cloudflare API MCP Server 执行。
-
查看执行结果: MCP 服务器会将 Cloudflare API 的响应返回给客户端,您可以在客户端中查看操作结果。
请注意: 使用此 MCP 服务器前,请确保您已拥有有效的 Cloudflare 账户和 API 密钥,并已正确配置到 Cloudflare Workers 中。
信息
分类
开发者工具