Cloudflare MCP Server 使用说明

项目简介

Cloudflare MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型（LLMs）客户端（如 Claude Desktop）与 Cloudflare 平台。它允许用户使用自然语言指令，通过 Claude Desktop 或其他兼容 MCP 协议的客户端，直接管理和操作其 Cloudflare 账户下的各项服务，例如部署 Worker、管理 KV 存储、操作 R2 存储桶、查询 D1 数据库以及获取 Analytics 数据。

主要功能点

Cloudflare 服务集成: 支持 Cloudflare Workers, KV Storage, R2 Storage, D1 数据库和 Analytics 等核心服务。
自然语言操作: 通过 MCP 协议，将自然语言指令转换为对 Cloudflare 服务的具体操作。
工具化能力: 提供一系列预定义的工具 (Tools)，例如列出 Workers, 创建 R2 存储桶, 查询 D1 数据库等，供 LLM 客户端调用。
易于安装和配置: 通过简单的 'npx' 命令即可完成安装和 Claude Desktop 的自动配置。
本地运行: 服务器可以在本地环境中运行，方便开发和测试。

安装步骤

前提条件: 确保已安装 Node.js 和 npm 或 pnpm。
执行安装命令: 打开终端，运行以下命令：
```
npx @cloudflare/mcp-server-cloudflare init
```
该命令将：
- 检查并确保您已通过 'wrangler' 命令行工具登录 Cloudflare 账户。如果未登录，会引导您完成登录。
- 自动配置 Claude Desktop 客户端，使其能够连接到 Cloudflare MCP Server。

服务器配置

对于 Claude Desktop，'init' 命令会自动完成配置。如果您使用其他 MCP 客户端或需要手动配置，以下是 MCP 客户端所需的服务器配置信息 (JSON 格式):

{
  "mcpServers": {
    "cloudflare": {  // 服务器名称，可以自定义
      "command": "/path/to/your/node",  // **[请替换为您的 Node.js 可执行文件路径]**。例如：/usr/bin/node 或 'which node' 命令的输出
      "args": [
        "/path/to/your/cloudflare_mcp-server-cloudflare/dist/index.js", // **[请替换为 cloudflare_mcp-server-cloudflare 项目 'dist/index.js' 文件的绝对路径]**。该路径指向服务器的入口文件。
        "run",
        "your_account_id" // **[请替换为您的 Cloudflare 账户 ID]**。账户 ID 可以在 Cloudflare 仪表板或 'wrangler whoami' 命令中找到。
      ]
    }
  }
}

注意：

'/path/to/your/node' 需要替换为您的 Node.js 可执行文件的实际路径。您可以使用 'which node' 命令在终端中查找。
'/path/to/your/cloudflare_mcp-server-cloudflare/dist/index.js' 需要替换为 'cloudflare_mcp-server-cloudflare' 项目编译后 'dist/index.js' 文件的绝对路径。请确保您已成功运行 'npm install' 或 'pnpm install' 以及 'npm run build' 或 'pnpm run build' 命令来构建项目。
'your_account_id' 需要替换为您的 Cloudflare 账户 ID。

基本使用方法

启动 MCP 客户端: 重启或启动您配置的 MCP 客户端 (例如 Claude Desktop)。
连接服务器: 客户端应该会自动连接到 Cloudflare MCP Server。您可能会在客户端界面看到一个 "🔨" 工具图标，表示 Cloudflare 工具已成功加载。
自然语言指令: 在 MCP 客户端中，您可以使用自然语言指令来操作 Cloudflare 服务。例如：
- "列出我的 Cloudflare Workers"
- "创建一个名为 'my-bucket' 的 R2 存储桶"
- "查询 D1 数据库 'my-database' 中的所有表"
- "获取我的域名的 Analytics 数据"

请参考仓库 README 文件和示例，了解更多可用的自然语言指令和工具功能。

关键词

Cloudflare MCP Server 使用说明

信息