项目简介
cloudflare-api-mcp 是一个基于 Model Control Protocol (MCP) 的服务器实现,专为LLM客户端(如Cursor)设计,用于通过一套标准接口调用Cloudflare的各项服务API,例如DNS、KV、R2、Queues等。它利用Cloudflare Workers的特性,提供一个安全、高效的后端服务。
主要功能点
- Cloudflare API调用: 将大量的Cloudflare REST API接口封装成LLM易于理解和使用的工具函数。
- 多种服务支持: 提供对Cloudflare DNS、KV存储、R2存储、Queues消息队列、Hyperdrive、Workers域名、Workers Cron触发器、Zones、Workflows等服务的操作能力。
- LLM 工具集成: LLM客户端可以直接通过调用这些封装好的工具函数来管理和操作您的Cloudflare资源。
- Cloudflare Workers 部署: 设计用于部署在Cloudflare Workers平台上,利用其边缘计算和安全性。
安装步骤
- 确保您已安装 'bun' 包管理器。
- 运行以下命令克隆项目并部署到您的Cloudflare账户:
按照提示完成部署。部署成功后,命令输出会包含用于MCP客户端连接的服务器配置信息。bun create mcp --clone https://github.com/zueai/cloudflare-api-mcp - 将您的Cloudflare API Key和API Email配置为Worker Secrets:
输入您的API Key和API Email值。bunx wrangler secret put CLOUDFLARE_API_KEY bunx wrangler secret put CLOUDFLARE_API_EMAIL
服务器配置
部署成功后,'bun create mcp' 命令会自动将服务器配置信息复制到您的剪贴板。您需要将此信息添加到您的MCP客户端(如Cursor)中。配置信息通常类似于以下JSON格式,但请以实际输出为准:
{ "name": "您部署的Worker名称,例如 cloudflare-api-mcp", "command": "wrangler", "args": [ "dev", "--remote" ] }
- 'name': 您在MCP客户端中识别该服务器的名称。
- 'command': 启动服务器的命令,这里使用 Cloudflare Wrangler CLI。
- 'args': 传递给启动命令的参数,'dev --remote' 表示以开发模式远程运行Worker。
基本使用方法
- 在MCP客户端中,找到添加/管理MCP服务器的选项,粘贴或输入您部署后获得的服务器配置信息。
- 连接到配置好的Cloudflare API MCP服务器。
- 客户端会自动发现服务器提供的工具(即封装的Cloudflare API函数及其JSDoc描述)。
- 您可以通过客户端的交互界面或直接在与LLM的对话中引用这些工具,让LLM代表您执行Cloudflare操作,例如列出域名、创建DNS记录、管理KV存储等。
- 例如,您可以尝试让LLM调用 'listZones' 工具来获取您的Cloudflare Zones列表。
信息
分类
网页与API