Cloudflare MCP Server
官方在Cloudflare开发者平台(例如Workers/KV/R2/D1)上部署、配置和查询您的资源
文档
Cloudflare MCP Server
模型上下文协议(MCP)是一种全新的标准化协议,用于管理大型语言模型(LLM)与外部系统之间的上下文。在此仓库中,您可以找到多个 MCP 服务器,允许您从 MCP 客户端(例如 Cursor、Claude)连接到 Cloudflare 服务,并使用自然语言通过您的 Cloudflare 账户完成任务。
这些 MCP 服务器允许您的 MCP 客户端 从您的账户读取配置、处理信息、基于数据提出建议,甚至为您执行这些建议的更改。所有这些操作都可以跨 Cloudflare 的众多服务进行,包括应用开发、安全和性能。
它们通过 /mcp 支持 streamable-http 传输,并通过 /sse 支持 sse 传输(已弃用)。
此仓库中包含以下服务器:
| 服务器名称 | 描述 | 服务器 URL |
|---|---|---|
| 文档服务器 | 获取 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 |
| 可观测性服务器 | 调试并获取应用日志和分析的洞察 | https://observability.mcp.cloudflare.com/mcp |
| 容器服务器 | 启动沙盒开发环境 | https://containers.mcp.cloudflare.com/mcp |
| 浏览器渲染服务器 | 获取网页,将其转换为 Markdown 并截图 | https://browser.mcp.cloudflare.com/mcp |
| Logpush 服务器 | 获取 Logpush 作业健康状况的快速摘要 | https://logs.mcp.cloudflare.com/mcp |
| AI Gateway 服务器 | 搜索您的日志,获取有关提示和响应的详细信息 | https://ai-gateway.mcp.cloudflare.com/mcp |
| 审计日志服务器 | 查询审计日志并生成报告以供审查 | https://auditlogs.mcp.cloudflare.com/mcp |
| DNS Analytics 服务器 | 根据当前设置优化 DNS 性能并调试问题 | https://dns-analytics.mcp.cloudflare.com/mcp |
| 数字体验监控服务器 | 快速获取组织关键应用的洞察 | https://dex.mcp.cloudflare.com/mcp |
| Cloudflare One CASB 服务器 | 快速识别 SaaS 应用的安全配置错误,以保护用户和数据 | https://casb.mcp.cloudflare.com/mcp |
| GraphQL 服务器 | 使用 Cloudflare 的 GraphQL API 获取分析数据 | https://graphql.mcp.cloudflare.com/mcp |
您应该使用哪个 Cloudflare MCP 服务器?
Cloudflare 提供两类 MCP 服务器:
- 代码模式服务器 (
mcp.cloudflare.com) 位于cloudflare/mcp: 最适合通过代码执行广泛访问 Cloudflare 的 API。 - 特定领域服务器 (
*.mcp.cloudflare.com) 位于此仓库: 最适合为特定 Cloudflare 产品领域提供精心设计的类型化工具。
何时使用每种服务器?
在以下情况下使用代码模式服务器:
- 您需要跨多个 Cloudflare 产品的广泛 API 覆盖
- 您更喜欢一组较小的通用工具
- 您的工作流程更适合通过代码执行来完成
在以下情况下使用此仓库中的特定领域服务器:
- 您需要为特定产品领域量身定制的工具
- 您希望获得更具引导性、类型化的交互
- 您主要在单个 Cloudflare 领域内工作,例如可观测性、Bindings、Radar 或浏览器渲染
在此处了解有关代码模式服务器的更多信息:cloudflare/mcp。
从任何 MCP 客户端访问远程 MCP 服务器
如果您的 MCP 客户端对远程 MCP 服务器有一流支持,客户端将提供一种在其界面内直接接受服务器 URL 的方式(例如 Cloudflare AI Playground)
如果您的客户端尚不支持远程 MCP 服务器,您需要使用 mcp-remote (https://www.npmjs.com/package/mcp-remote) 设置其相应的配置文件,以指定您的客户端可以访问哪些服务器。
{
"mcpServers": {
"cloudflare-observability": {
"command": "npx",
"args": ["mcp-remote", "https://observability.mcp.cloudflare.com/mcp"]
},
"cloudflare-bindings": {
"command": "npx",
"args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"]
}
}
}
从 OpenAI Responses API 使用 Cloudflare 的 MCP 服务器
要将 Cloudflare 的某个 MCP 服务器与 OpenAI 的 Responses API 一起使用,您需要向 Responses API 提供一个具有该特定 MCP 服务器所需范围(权限)的 API 令牌。
例如,要将浏览器渲染 MCP 服务器与 OpenAI 一起使用,请在 Cloudflare 仪表板此处创建一个 API 令牌,并具有以下权限:
需要访问更多 Cloudflare 工具?
我们将继续为此远程 MCP 服务器仓库添加更多功能。如果您想提供反馈、提交错误或提出功能请求,请在此仓库上提交 issue
故障排除
“Claude 的响应被中断...”
如果您看到此消息,Claude 可能达到了其上下文长度限制并中途停止回复。这种情况最常发生在触发许多链式工具调用的服务器上,例如可观测性服务器。
为减少遇到此问题的可能性:
- 尽量具体,保持查询简洁。
- 如果单个请求调用多个工具,请尝试将其分解为几个较小的工具调用,以保持响应简短。
付费功能
某些功能可能需要付费的 Cloudflare Workers 计划。请确保您的 Cloudflare 账户具有您打算使用的功能所需的订阅级别。
贡献
有兴趣贡献并在本地运行此服务器?请参阅 CONTRIBUTING.md 开始。