适用于 IDE 的 Cloudflare MCP 服务器
模型上下文协议 (MCP) 是一种新的标准化协议，用于管理大型语言模型 (LLM) 与外部系统之间的上下文。在此存储库中，我们提供了Cloudflare API 的安装程序和 MCP 服务器。
这使您可以使用 Claude Desktop 和 VSCode（Cline）和 Windsurf 等 IDE 或任何 MCP 客户端，使用自然语言在您的 Cloudflare 帐户上完成操作，例如：
Please deploy me a new Worker with an example durable object.Can you tell me about the data in my D1 database named '...'?Can you copy all the entries from my KV namespace '...' into my R2 bucket '...'?
演示
Related MCP server: Remote MCP Server Authless
设置
运行
npx @gutmutcode/mcp-server-cloudflare init重新启动 Claude Desktop，您应该会看到一个小的🔨图标，其中显示以下可用的工具：
检查 Cline 配置文件，您应该会看到一个包含您的 Cloudflare 帐户 ID 的
cloudflare部分。检查你的 Windsurf MCP 配置文件，你也应该会看到一个
cloudflare部分。Windsurf 对 MCP 工具的使用有所限制，所以你不能同时使用太多工具。（与 Cline 和 Claude 不同）
特征
KV门店管理
get_kvs：列出您帐户中的所有 KV 命名空间kv_get：从 KV 命名空间获取值kv_put：将值存储在 KV 命名空间中kv_list：列出 KV 命名空间中的键kv_delete：从 KV 命名空间中删除一个键
R2 存储管理
r2_list_buckets：列出您帐户中的所有 R2 存储桶r2_create_bucket：创建一个新的 R2 存储桶r2_delete_bucket：删除 R2 存储桶r2_list_objects：列出 R2 存储桶中的对象r2_get_object：从 R2 存储桶中获取对象r2_put_object：将对象放入 R2 存储桶r2_delete_object：从 R2 存储桶中删除对象
D1 数据库管理
d1_list_databases：列出您账户中的所有 D1 数据库d1_create_database：创建一个新的 D1 数据库d1_delete_database：删除 D1 数据库d1_query：对 D1 数据库执行 SQL 查询
工人管理
worker_list：列出您账户中的所有工人worker_get：获取 Worker 的脚本内容worker_put：创建或更新 Worker 脚本worker_delete：删除 Worker 脚本
分析
analytics_get：检索域的分析数据包括请求、带宽、威胁和页面浏览量等指标
支持日期范围过滤
发展
在当前项目文件夹中，运行：
pnpm install
pnpm build:watch然后，在第二个终端中：
node dist/index.js init这会将 Claude Desktop 与您本地安装的版本链接起来以供您测试。
Claude 之外的用法
要在本地运行服务器，请运行node dist/index run <account-id> 。
如果您正在使用其他 MCP 客户端，或者在本地进行测试，请执行tools/list命令以获取所有可用工具的最新列表。然后，您可以使用tools/call命令直接调用这些工具。
工人
// List workers
worker_list()
// Get worker code
worker_get({ name: "my-worker" })
// Update worker
worker_put({
name: "my-worker",
script: "export default { async fetch(request, env, ctx) { ... }}",
bindings: [
{
type: "kv_namespace",
name: "MY_KV",
namespace_id: "abcd1234"
},
{
type: "r2_bucket",
name: "MY_BUCKET",
bucket_name: "my-files"
}
],
compatibility_date: "2024-01-01",
compatibility_flags: ["nodejs_compat"]
})
// Delete worker
worker_delete({ name: "my-worker" })KV商店
// List KV namespaces
get_kvs()
// Get value
kv_get({
namespaceId: "your_namespace_id",
key: "myKey"
})
// Store value
kv_put({
namespaceId: "your_namespace_id",
key: "myKey",
value: "myValue",
expirationTtl: 3600 // optional, in seconds
})
// List keys
kv_list({
namespaceId: "your_namespace_id",
prefix: "app_", // optional
limit: 10 // optional
})
// Delete key
kv_delete({
namespaceId: "your_namespace_id",
key: "myKey"
})R2 存储
// List buckets
r2_list_buckets()
// Create bucket
r2_create_bucket({ name: "my-bucket" })
// Delete bucket
r2_delete_bucket({ name: "my-bucket" })
// List objects in bucket
r2_list_objects({
bucket: "my-bucket",
prefix: "folder/", // optional
delimiter: "/", // optional
limit: 1000 // optional
})
// Get object
r2_get_object({
bucket: "my-bucket",
key: "folder/file.txt"
})
// Put object
r2_put_object({
bucket: "my-bucket",
key: "folder/file.txt",
content: "Hello, World!",
contentType: "text/plain" // optional
})
// Delete object
r2_delete_object({
bucket: "my-bucket",
key: "folder/file.txt"
})D1 数据库
// List databases
d1_list_databases()
// Create database
d1_create_database({ name: "my-database" })
// Delete database
d1_delete_database({ databaseId: "your_database_id" })
// Execute a single query
d1_query({
databaseId: "your_database_id",
query: "SELECT * FROM users WHERE age > ?",
params: ["25"] // optional
})
// Create a table
d1_query({
databaseId: "your_database_id",
query: `
CREATE TABLE users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
email TEXT UNIQUE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)
`
})分析
// Get today's analytics
analytics_get({
zoneId: "your_zone_id",
since: "2024-11-26T00:00:00Z",
until: "2024-11-26T23:59:59Z"
})贡献
欢迎贡献代码！欢迎提交 Pull 请求。