BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN MCP 服务

BlazingCDN 的官方 Model Context Protocol 服务。让 AI Agent（Claude、Cursor、Windsurf 及任何其他 MCP 客户端）管理您的 CDN：列出并配置资源、清除和预热缓存、查询流量指标、管理自定义域名、云存储和 Video CDN。

BlazingCDN 是面向视频、软件和体育媒体的 CDN，适用于视频、流媒体（HLS/DASH）、软件分发、游戏和更新、图像、音频、存档及其他大型文件。专为每月传输 5 TB 以上流量的大型项目打造。

亮点

• 52 个工具，涵盖 Anycast CDN、缓存操作、指标、自定义域名、Cloud Storage 和 Video CDN
• 默认安全——以只读模式启动（另支持清除和预热缓存）；创建/更新和删除操作需通过环境标志显式启用
• 无需安装——使用 npx 运行
• 直接通过您的 API 令牌调用 BlazingCDN API（wapi.blazingcdn.com）；中间不经过其他服务

获取账户和 API 令牌

1. 在 blazingcdn.com 注册——每个新账户均可享受 14 天试用期。试用期仅有时间限制：不包含免费流量，试用期间使用的流量按正常的 $5/TB 费率计费。
2. **立即充值至少 $10 **，避免测试期间账户余额变为负数。
3. 创建 API 访问令牌：在 BlazingCDN 面板中打开 API → 创建新的 API 凭据（或使用 POST /api/v1/access_tokens）。

定价（Flex 套餐）

试用期结束后，您将使用按量付费的 Flex 套餐，每月最低收费 $25，包含前 5 TB 流量。流量按阶梯费率计费：

每月流量	每 TB 价格
前 5 TB	$5.00
5–25 TB	$4.50
25–100 TB	$4.00
100–500 TB	$3.50
500–1000 TB	$3.00
1000–1500 TB	$2.50

所有套餐均包含自定义域名、无限请求、源站屏蔽、URL 签名、免费 SSL 和地理位置允许/屏蔽列表——不收取任何功能附加费。每月流量超过 100 TB？ 联系 BlazingCDN 申请定制大流量价格。

快速开始

Claude Desktop — 一键安装（无需终端）

从 Releases 下载最新的 .mcpb 包并双击，Claude Desktop 会提示您输入 API 令牌，并显示两个复选框：允许更改（创建和更改 CDN 设置）以及允许删除（自定义域名和 Video CDN 资源）。两项默认均为关闭，因此服务会以只读模式启动。无需安装 Node.js。

Claude Code

claude mcp add blazingcdn --env BLAZINGCDN_API_TOKEN=your-token -- npx -y @blazingcdn/mcp

Claude Desktop / Cursor / Windsurf

将以下内容添加到 MCP 配置文件（claude_desktop_config.json、.cursor/mcp.json 等）：

{
  "mcpServers": {
    "blazingcdn": {
      "command": "npx",
      "args": ["-y", "@blazingcdn/mcp"],
      "env": {
        "BLAZINGCDN_API_TOKEN": "your-token"
      }
    }
  }
}

也可以从 GitHub 而非 npm 运行：将 "args" 替换为 ["-y", "github:BlazingCDN/BlazingCDN-MCP"]。

配置

环境变量	必填	说明
BLAZINGCDN_API_TOKEN	是	API 访问令牌（Bearer）
BLAZINGCDN_API_URL	否	API 基础 URL，默认为 https://wapi.blazingcdn.com
BLAZINGCDN_ALLOW_WRITE	否	设为 1 可启用创建/更新工具
BLAZINGCDN_ALLOW_DELETE	否	设为 1 可启用删除工具（delete_custom_domain、delete_vcdn_resource）

权限模型

模式	工具数	Agent 可以执行的操作
默认	29	读取所有内容 + 清除/预热缓存
BLAZINGCDN_ALLOW_WRITE=1	50	…还可以创建/更新 CDN 资源、域名、存储桶和 Video CDN
…+ BLAZINGCDN_ALLOW_DELETE=1	52	…还可以删除自定义域名和 vCDN 资源

完全未实现删除 CDN 资源（拉取区域）、存储桶、外部存储、账户或用户的功能——在任何模式下，都无法通过此服务触发这些操作。

功能关闭时

此服务可以更改的每项设置，在客户面板中也都有对应的开关。如果你请求的功能在你的资源上处于关闭状态——例如图像处理、HLS/DASH 支持或源站屏蔽——Agent 会准确告知你在哪里启用它（client.blazingcdn.com/anycast_cdn/<resource_id>/<tab>）；或者，在设置 BLAZINGCDN_ALLOW_WRITE=1 后，Agent 可以为你启用该功能，并等待你的确认。

工具

Anycast CDN

工具	描述
list_cdn_resources	列出所有 CDN 资源（拉取区域）
get_cdn_resource	获取单个资源的完整设置
purge_cache	清除全部缓存或指定 URL 的缓存；可针对单个资源操作，也可按 URL 跨资源操作
warmup_cache	将路径预取到缓存中（按压缩方式）
get_cdn_metrics	按天／小时／分钟查看带宽、缓存命中、请求、HTTP 状态码和流量；可按区域／域名筛选
get_prometheus_metrics	获取 Prometheus 格式的监控指标
create_cdn_resource ✏️	创建拉取区域（源站、存储桶或外部存储）
update_cdn_resource ✏️	更新 TTL、压缩、源站屏蔽、HTTPS、访问保护、HLS/DASH、图像处理、Locations Mode 等设置
bulk_update_cdn_resources ✏️	对多个资源应用相同设置
update_cdn_locations ✏️	设置按路径划分的缓存规则和图像预设（需要 Locations Mode 为 extended）

域名与 DNS

工具	描述
list_custom_domains / search_custom_domains	列出资源的域名／匹配整个账户中的域名
list_system_dns_zones	列出 CDN 主机名对应的系统 DNS 区域
add_custom_domain ✏️ / update_custom_domain ✏️	关联域名、管理 SSL（自动 SSL／证书）
delete_custom_domain 🗑️	移除自定义域名

云存储

list_buckets、get_bucket、get_bucket_metrics、get_storage_info、create_bucket ✏️、update_bucket ✏️、list_external_storages、get_external_storage、create_external_storage ✏️、update_external_storage ✏️、test_external_storage_connection ✏️

用作 CDN 资源源站的存储桶必须为 cdn 类型；create_bucket 默认会创建此类型（private 存储桶无法关联到拉取区域）。对于兼容 S3 的存储桶，请传入 protocol: "s3"；创建后无法更改协议。

视频 CDN

list_vcdn_resources、get_vcdn_resource、get_vcdn_statistics（总计、时间序列、按域名统计、热门域名、HTTP 状态码、带宽、缓存／存储）、list_vcdn_domains、get_vcdn_domain、list_vcdn_files、get_vcdn_files_total、list_ftp_logins、list_auto_imports、get_vcdn_proxy、get_vcdn_ftp_settings、get_vcdn_settings、create_vcdn_resource ✏️、update_vcdn_resource ✏️、create_vcdn_domain ✏️、update_vcdn_domain ✏️、upload_vcdn_file ✏️、manage_auto_import ✏️、update_vcdn_proxy ✏️、update_vcdn_ftp_settings ✏️、manage_ftp_login ✏️、update_vcdn_settings ✏️、delete_vcdn_resource 🗑️

文档与定价

search_docs — 搜索 BlazingCDN 文档和产品页面。 estimate_traffic_cost — 根据给定流量估算 Flex 套餐的月度费用（阶梯计价，离线计算）。

✏️ 需要设置 BLAZINGCDN_ALLOW_WRITE=1 · 🗑️ 需要设置 BLAZINGCDN_ALLOW_DELETE=1

示例提示词

• “我本月的 CDN 带宽是多少？按天细分。”
• “清除 blazingcdn.com 资源上 /images/* 的缓存”
• “为源站 https://example.com 创建 CDN 资源，并关联启用自动 SSL 的 cdn.example.com”
• “显示过去 24 小时各区域的 HTTP 5xx 错误率”
• “使用 brotli 压缩预热 /video/intro.mp4”
• “BlazingCDN 每月 190 TB 的费用是多少？”
• “为 shop-images 资源启用图像处理，并提供 /images/iphone.jpg 的 200×200 缩略图 URL”

HTTP 传输（自托管）

此服务还支持 Streamable HTTP，可用于远程部署：

BLAZINGCDN_ALLOW_WRITE=1 npx -y @blazingcdn/mcp --transport http --port 8462

在 HTTP 模式下，服务是无状态的，每个请求都必须携带调用方的 BlazingCDN API 令牌，格式为 Authorization: Bearer <token>（环境变量 BLAZINGCDN_API_TOKEN 可作为备用）。对外开放之前，请将其置于 TLS（反向代理）之后。

开发

npm install
npm test        # vitest
npm run build   # tsc -> dist/
npx @modelcontextprotocol/inspector node dist/index.js   # interactive inspector

隐私政策

此服务不会收集任何信息：没有遥测、分析或第三方调用。你的 API 令牌会保留在进程内存中，且仅通过 HTTPS 发送至 BlazingCDN API。完整政策：PRIVACY.md · 服务级数据处理：BlazingCDN 法律信息。

安全说明

• API 令牌从环境变量中读取，且仅发送至 BLAZINGCDN_API_URL；绝不会记录到日志中。没有中间人，也没有遥测。
• 默认只读；任何模式下均未实现破坏性操作（删除区域／存储桶／账户）。
• 工具输出会截断至 60 KB，以保持 Agent 上下文精简。
• API 请求在 30 秒后超时（文件上传：5 分钟）。

完整威胁模型、限制和建议：SECURITY.md。

许可证

MIT © BlazingCDN