关于 Cloudflare MCP Server
Cloudflare MCP Server 仓库提供面向 Cloudflare 各产品领域的 MCP 服务,供 MCP 客户端通过自然语言读取配置、分析数据并执行建议的变更。既有通用 API 服务,也有面向特定领域的类型化工具。
主要功能
- 01访问 Cloudflare 账户配置
- 02分析数据并提出建议
- 03覆盖文档、容器和浏览器等领域
- 04提供专用领域工具
- 05通过无状态 HTTP 端点连接
适用场景
- 01查询 Cloudflare 文档
- 02运行沙箱开发环境
- 03获取网页内容或截图
- 04检查 SaaS 安全配置
MCP 相关
仓库中的服务通过 `/mcp` 提供 Streamable HTTP 端点,可由支持远程服务的 MCP 客户端连接。另有覆盖广泛 API 的 Cloudflare API MCP Server。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://docs.mcp.cloudflare.com/mcpclaude mcp add --transport http cloudflare https://docs.mcp.cloudflare.com/mcp{"mcpServers":{"cloudflare":{"type":"http","url":"https://docs.mcp.cloudflare.com/mcp"}}}在 Cursor 中打开{"servers":{"cloudflare":{"type":"http","url":"https://docs.mcp.cloudflare.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"cloudflare":{"type":"http","url":"https://docs.mcp.cloudflare.com/mcp"}}}{"mcpServers":{"cloudflare":{"serverUrl":"https://docs.mcp.cloudflare.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://docs.mcp.cloudflare.com/mcphttps://observability.mcp.cloudflare.com/mcp需要授权https://bindings.mcp.cloudflare.com/mcp需要授权https://builds.mcp.cloudflare.com/mcp需要授权https://radar.mcp.cloudflare.com/mcp需要授权https://containers.mcp.cloudflare.com/mcp需要授权https://browser.mcp.cloudflare.com/mcp需要授权https://logs.mcp.cloudflare.com/mcp需要授权https://ai-gateway.mcp.cloudflare.com/mcp需要授权https://autorag.mcp.cloudflare.com/mcp需要授权https://auditlogs.mcp.cloudflare.com/mcp需要授权https://dns-analytics.mcp.cloudflare.com/mcp需要授权https://dex.mcp.cloudflare.com/mcp需要授权https://casb.mcp.cloudflare.com/mcp需要授权https://graphql.mcp.cloudflare.com/mcp需要授权https://docs.mcp.cloudflare.com/ssehttps://observability.mcp.cloudflare.com/sse需要授权https://bindings.mcp.cloudflare.com/sse需要授权https://builds.mcp.cloudflare.com/sse需要授权https://radar.mcp.cloudflare.com/sse需要授权https://containers.mcp.cloudflare.com/sse需要授权https://browser.mcp.cloudflare.com/sse需要授权https://logs.mcp.cloudflare.com/sse需要授权https://ai-gateway.mcp.cloudflare.com/sse需要授权https://autorag.mcp.cloudflare.com/sse需要授权https://auditlogs.mcp.cloudflare.com/sse需要授权https://dns-analytics.mcp.cloudflare.com/sse需要授权https://dex.mcp.cloudflare.com/sse需要授权https://casb.mcp.cloudflare.com/sse需要授权https://graphql.mcp.cloudflare.com/sse需要授权工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 |
详细介绍
Cloudflare MCP 服务
模型上下文协议(MCP)是一种新的标准化协议,用于管理大语言模型(LLM)与外部系统之间的上下文。在此代码仓库中,你可以找到多个 MCP 服务,让你通过 MCP 客户端(例如 Cursor、Claude)连接到 Cloudflare 服务,并通过 Cloudflare 帐户使用自然语言完成任务。
这些 MCP 服务可让你的 MCP 客户端读取帐户中的配置、处理信息、基于数据提出建议,甚至替你应用这些建议的更改。所有这些操作都可以在 Cloudflare 的多种服务中完成,包括应用开发、安全和性能。
此代码仓库中的每个服务都通过全新的 SDK v2 服务工厂,在 /mcp 提供无状态的 Streamable HTTP 处理程序。已弃用的 /sse URL 会对每个请求返回 410 Gone Problem Details 响应,其中会指出 /mcp URL;MCP 客户端会在连接错误中显示该响应消息。现代的 2026 请求和无状态的 2025 请求共用同一套请求级实现,且无需 MCP 协议会话。OAuth、凭据、帐户选择、应用缓存以及产品 Durable Objects 在需要时仍作为应用/安全状态保留。
Cloudflare 提供以下 MCP 服务。此代码仓库包含特定领域的服务,而推荐的 Cloudflare API MCP 服务由 cloudflare/mcp 维护:
| 服务名称 | 描述 | 服务 URL |
|---|---|---|
| Cloudflare API MCP 服务(推荐) | 如果你希望通过代码执行广泛访问 Cloudflare API,这是最佳选择 | https://mcp.cloudflare.com/mcp |
| 文档服务 | 获取最新的 Cloudflare 参考信息 | https://docs.mcp.cloudflare.com/mcp |
| 容器服务 | 启动沙盒开发环境 | https://containers.mcp.cloudflare.com/mcp |
| Browser Run 服务 | 获取网页、将其转换为 Markdown 并截图 | https://browser.mcp.cloudflare.com/mcp |
| 数字体验监控服务 | 快速了解组织的关键应用 | https://dex.mcp.cloudflare.com/mcp |
| Cloudflare One CASB 服务 | 快速识别 SaaS 应用的安全配置错误,保护用户和数据 | https://casb.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 API MCP Server](https://mcp.cloudflare.com/mcp)。| 服务名称 | 说明 | 服务 URL |
|---|---|---|
| AI Gateway server | 搜索日志,查看提示词和响应的详细信息 | https://ai-gateway.mcp.cloudflare.com/mcp |
| Audit Logs server | 查询审计日志并生成报告以供审核 | https://auditlogs.mcp.cloudflare.com/mcp |
| AutoRAG server | 搜索和查询账户中的 AutoRAG 实例 | https://autorag.mcp.cloudflare.com/mcp |
| DNS Analytics server | 根据当前设置优化 DNS 性能并排查问题 | https://dns-analytics.mcp.cloudflare.com/mcp |
| GraphQL server | 使用 Cloudflare 的 GraphQL API 获取分析数据 | https://graphql.mcp.cloudflare.com/mcp |
| Logpush server | 快速获取 Logpush 作业运行状况摘要 | https://logs.mcp.cloudflare.com/mcp |
| Observability server | 排查问题并深入了解应用程序的日志和分析数据 | https://observability.mcp.cloudflare.com/mcp |
| Radar server | 探索 Cloudflare Radar 的互联网洞察 | https://radar.mcp.cloudflare.com/mcp |
| Workers Bindings server | 使用存储、AI 和计算原语构建 Workers 应用程序 | https://bindings.mcp.cloudflare.com/mcp |
| Workers Builds server | 深入了解并管理 Cloudflare Workers Builds | https://builds.mcp.cloudflare.com/mcp |
应该使用哪个 Cloudflare MCP 服务?
Cloudflare 提供两类 MCP 服务:
- Cloudflare API MCP Server(
mcp.cloudflare.com),位于cloudflare/mcp: 适用于希望通过代码执行广泛访问 Cloudflare API 的场景。 - 本仓库中的特定领域服务(
*.mcp.cloudflare.com): 适用于希望使用针对特定 Cloudflare 产品领域精选的类型化工具的场景。
应该在什么情况下使用它们?
在以下情况下使用 Cloudflare API MCP Server:
- 你需要广泛覆盖多个 Cloudflare 产品的 API
- 你倾向于使用一组更精简的通用工具
- 代码执行更适合你的工作流
在以下情况下使用本仓库中的特定领域服务:
- 你需要针对特定产品领域打造的专用工具
- 你希望获得更具引导性的类型化交互
- 你的工作主要集中在 Browser Run 或容器等某个 Cloudflare 领域
在此处了解有关 Cloudflare API MCP Server 的更多信息:cloudflare/mcp。
连接到 MCP 服务
将任何支持远程服务的 MCP 客户端直接连接到上表中的 URL。 Cloudflare AI Playground 也支持在其界面中输入服务 URL。
通过 OpenAI Responses API 使用 Cloudflare 的 MCP 服务
要通过 OpenAI 的 responses API 使用 Cloudflare 的某个 MCP 服务,你需要向 Responses API 提供一个 API 令牌,该令牌具有对应 MCP 服务所需的作用域(权限)。
例如,要通过 OpenAI 使用 Browser Run MCP 服务,请在 Cloudflare 控制面板此处创建一个 API 令牌,并授予以下权限:
需要访问更多 Cloudflare 工具吗?
我们会继续为这个远程 MCP 服务仓库添加更多功能。如果你想提供反馈、报告 Bug 或提出功能请求,请在此仓库中提交 issue
故障排查
“Claude 的回复被中断……”
如果你看到此消息,Claude 可能达到了上下文长度限制,并在回复中途停止。这种情况最常见于会触发多次串联工具调用的服务,例如可观测性服务。
为降低遇到此问题的可能性:
- 尽量具体,保持查询简洁。
- 如果单个请求调用了多个工具,尝试将其拆分为几个较小的工具调用,以缩短回复。
付费功能
某些功能可能需要付费的 Cloudflare Workers 计划。请确保你的 Cloudflare 账户订阅级别满足你打算使用的功能的要求。
贡献
有兴趣参与贡献并在本地运行此服务吗?请参阅 CONTRIBUTING.md 以开始。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。