项目简介

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平台上,利用其边缘计算和安全性。

安装步骤

  1. 确保您已安装 'bun' 包管理器。
  2. 运行以下命令克隆项目并部署到您的Cloudflare账户:
    bun create mcp --clone https://github.com/zueai/cloudflare-api-mcp
    按照提示完成部署。部署成功后,命令输出会包含用于MCP客户端连接的服务器配置信息。
  3. 将您的Cloudflare API Key和API Email配置为Worker Secrets:
    bunx wrangler secret put CLOUDFLARE_API_KEY
    bunx wrangler secret put CLOUDFLARE_API_EMAIL
    输入您的API Key和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。

基本使用方法

  1. 在MCP客户端中,找到添加/管理MCP服务器的选项,粘贴或输入您部署后获得的服务器配置信息。
  2. 连接到配置好的Cloudflare API MCP服务器。
  3. 客户端会自动发现服务器提供的工具(即封装的Cloudflare API函数及其JSDoc描述)。
  4. 您可以通过客户端的交互界面或直接在与LLM的对话中引用这些工具,让LLM代表您执行Cloudflare操作,例如列出域名、创建DNS记录、管理KV存储等。
  5. 例如,您可以尝试让LLM调用 'listZones' 工具来获取您的Cloudflare Zones列表。

信息

分类

网页与API