cloudflare/mcp-server-cloudflare

发布时间 2026-09-23 8 天前
来源 GitHub TypeScript
字数 3,008 字
查看原文

补充自 2026年09月23日

AI智能总结

Cloudflare 在其开源仓库 cloudflare/mcp-server-cloudflare 中提供多款 MCP 服务器,使用户可在 Cursor、Claude 等客户端通过自然语言借助 Cloudflare 账号读取配置、处理数据并执行变更,覆盖应用开发、安全与性能等多个领域。

Model Context Protocol(MCP,模型上下文协议)是一种用于管理大语言模型(LLM)与外部系统之间上下文的标准化协议。在本仓库中,你可以找到多个 MCP 服务器,允许你从 MCP 客户端(例如 Cursor、Claude)连接到 Cloudflare 的服务,并通过自然语言借助 Cloudflare 账号完成任务。

这些 MCP 服务器可以让你的 MCP 客户端读取账号中的配置、处理信息、基于数据给出建议,甚至代为执行这些建议的更改。所有这些操作都可以跨 Cloudflare 的众多服务进行,包括应用开发、安全与性能。

本仓库中的每个服务器都通过全新的 SDK v2 服务器工厂,在 /mcp 与 /sse 这两个路径上暴露相同的无状态 Streamable HTTP 处理器。/sse 仅作为 URL 兼容别名存在,并不会使用已弃用的 HTTP+SSE 传输方式。对于旧的 GET /sse SSE 请求,会返回 410 Gone 的 Problem Details 响应,并提供两种迁移方案:将现有 URL 配置为使用 Streamable HTTP,或切换到推荐的 /mcp URL 以保证未来的兼容性。2026 年的现代请求与 2025 年的无状态请求共享同一个请求作用域实现,不会建立 MCP 协议会话。OAuth、凭据、账号选择、应用缓存以及产品级 Durable Object 仍然在需要时作为应用/安全态存在。

Cloudflare 提供以下 MCP 服务器。领域专用服务器包含在本仓库中,而推荐的 Code Mode 服务器则维护在 cloudflare/mcp:

服务器名称 描述 服务器 URL
Code Mode 服务器(推荐) 当你希望通过代码执行广泛访问 Cloudflare API 时为最佳选择 https://mcp.cloudflare.com/mcp
Documentation 服务器 获取最新的 Cloudflare 参考信息 https://docs.mcp.cloudflare.com/mcp
Workers Bindings 服务器 使用存储、AI 与计算原语构建 Workers 应用 https://bindings.mcp.cloudflare.com/mcp
Workers Builds 服务器 获取洞察并管理你的 Cloudflare Workers Builds https://builds.mcp.cloudflare.com/mcp
Observability 服务器 调试并获取应用日志与分析的洞察 https://observability.mcp.cloudflare.com/mcp
Container 服务器 启动一个沙箱开发环境 https://containers.mcp.cloudflare.com/mcp
Browser Run 服务器 获取网页、将其转换为 Markdown 并截图 https://browser.mcp.cloudflare.com/mcp
Logpush 服务器 快速获取 Logpush 任务健康状态的摘要 https://logs.mcp.cloudflare.com/mcp
AI Gateway 服务器 搜索日志,获取 prompt 与 response 的详细信息 https://ai-gateway.mcp.cloudflare.com/mcp
AutoRAG 服务器 搜索并查询账号中的 AutoRAG 实例 https://autorag.mcp.cloudflare.com/mcp
Audit Logs 服务器 查询审计日志并生成报告供审阅 https://auditlogs.mcp.cloudflare.com/mcp
DNS Analytics 服务器 基于当前配置优化 DNS 性能并调试问题 https://dns-analytics.mcp.cloudflare.com/mcp
Digital Experience Monitoring 服务器 快速获取组织内关键应用的洞察 https://dex.mcp.cloudflare.com/mcp
Cloudflare One CASB 服务器 快速识别 SaaS 应用中可能危及用户与数据的安全误配置 https://casb.mcp.cloudflare.com/mcp
Radar 服务器 探索 Cloudflare Radar 的互联网洞察 https://radar.mcp.cloudflare.com/mcp
Cloudflare Blog 服务器 搜索并阅读 Cloudflare Blog 上的文章 https://blog.mcp.cloudflare.com/mcp
Demo Day 服务器 演示一个最小化的 Cloudflare MCP 服务器 https://demo-day.mcp.cloudflare.com/mcp

应当选择哪一个 Cloudflare MCP 服务器?

Cloudflare 提供两类 MCP 服务器:

  • Code Mode 服务器(mcp.cloudflare.com),位于 cloudflare/mcp:当你希望通过代码执行广泛访问 Cloudflare API 时为最佳选择。
  • 领域专用服务器(*.mcp.cloudflare.com),位于本仓库:当你希望针对特定 Cloudflare 产品领域使用经过策展的、类型化的工具时为最佳选择。

何时应当使用哪一个?

在以下情况下使用 Code Mode 服务器:

  • 你需要跨多个 Cloudflare 产品获得广泛的 API 覆盖;
  • 你倾向于使用更少量、用途更通用的工具;
  • 你的工作流更适合通过代码执行来完成。

在以下情况下使用本仓库中的 领域专用服务器:

  • 你希望针对某一特定产品领域使用为此而设计的工具;
  • 你希望获得更有引导性、类型化的交互;
  • 你主要在某一个 Cloudflare 领域内工作,例如可观测性、Bindings、Radar 或 Browser Run。

在此处了解更多关于 Code Mode 服务器的信息:cloudflare/mcp。

连接到 MCP 服务器

任何支持远程服务器的 MCP 客户端都可以直接连接到上表中的某个 URL。Cloudflare AI Playground 也接受在界面中填入服务器 URL。

通过 OpenAI Responses API 使用 Cloudflare 的 MCP 服务器

要将 Cloudflare 的某个 MCP 服务器与 OpenAI 的 Responses API 一起使用,你需要向 Responses API 提供一个具有该 MCP 服务器所需 scopes(权限)的 API token。

例如,要将 Browser Run MCP 服务器 与 OpenAI 配合使用,请在 Cloudflare 控制台此处创建一个 API token,并为其授予以下权限:

Screenshot 2025-05-21 at 10 38 02 AM

需要访问更多 Cloudflare 工具?

我们会持续为这个远程 MCP 服务器仓库添加更多功能。如果你希望留下反馈、提交 bug 或提出功能请求,请在本仓库提交一个 issue。

故障排查

"Claude's response was interrupted ..."

如果看到这条消息,通常意味着 Claude 触达了其上下文长度上限并在回复中途停止。这种情况最容易在会触发大量链式工具调用的服务器上发生,例如可观测性服务器。

为降低遇到此问题的概率:

  • 尽量保持具体,让你的查询简洁明了。
  • 如果单个请求会调用多个工具,尝试将其拆分成若干较小的工具调用,以保持每次响应较短。

付费功能

部分功能可能需要付费版的 Cloudflare Workers 套餐。请确保你的 Cloudflare 账号已开通你打算使用的功能所对应的订阅等级。