用途
deploy-mcp 是一个面向 AI 助手的通用部署追踪工具。它允许开发者在不中断 AI 对话的情况下,直接查看所配置平台的部署状态,避免频繁切换窗口或跳转到各平台仪表板。该项目为开源项目,遵循 Apache 2.0 许可证。
主要能力
- 多平台支持:可同时配置并追踪 Vercel、Netlify、Cloudflare Pages 等多个部署平台。
- 部署状态查询:在 AI 对话中检查指定项目或站点的部署状态、查看最新部署、获取部署日志、跟踪部署进度。
- 项目/站点列表:列出所有已配置平台的项目或站点,并可查看最近多次部署记录。
- 部署状态徽章:为公开仓库生成实时部署状态徽章,通过 shields.io 端点封装展示。支持配置 Webhook 实现徽章实时更新。
- 本地令牌隐私:API 令牌仅保存在用户本机,无遥测数据收集,仅需最小读取权限。
使用方式
在 AI 助手中配置 MCP 服务并设置对应平台的环境变量(令牌),即可通过自然语言命令使用。
支持的 AI 助手配置位置包括:
- Claude Desktop:macOS 为
~/Library/Application Support/Claude/claude_desktop_config.json,Windows 为%APPDATA%\Claude\claude_desktop_config.json,Linux 为~/.config/Claude/claude_desktop_config.json; - VS Code(需启用 MCP 的 GitHub Copilot 订阅):工作区
.vscode/mcp.json,全局~/.vscode/mcp.json; - Cursor:
~/.cursor/mcp.json,设置路径为 Cursor Settings → MCP; - Windsurf:
~/.codeium/windsurf/mcp_config.json,设置路径为 Settings → Advanced Settings → Cascade; - Continue:
~/.continue/config.json; - Cline(VS Code 扩展):MCP Servers 图标 → Advanced MCP Settings,也支持自然语言添加。
各平台令牌配置示例:
- Vercel:
{ "env": { "VERCEL_TOKEN": "your-vercel-token" } } - Netlify:
{ "env": { "NETLIFY_TOKEN": "your-netlify-token" } } - Cloudflare Pages:
{ "env": { "CLOUDFLARE_TOKEN": "your-cloudflare-token-or-accountId:globalApiKey" } }
Cloudflare 支持两种令牌格式:API Token(需额外设置 CLOUDFLARE_ACCOUNT_ID 环境变量)或 Global API Key(accountId:globalApiKey 一体化格式)。
命令示例(跨平台通用):
- “Check my Vercel deployment for project-name”
- “Show me Netlify deployment logs”
- “Watch my Cloudflare Pages deployment progress”
- “List all my Vercel projects”
AI 会根据命令中明确提及的平台、项目/站点名称匹配以及配置中可用的令牌自动选择正确的平台。
部署状态徽章
deploy-mcp.io 端点返回 JSON 数据供 shields.io 使用,通过 shields.io 的 endpoint 封装展示徽章。
Webhook 配置方式:
- Vercel:在团队设置 → Webhooks → Create Webhook 中配置 URL
https://deploy-mcp.io/webhook/{username}/{repo}/vercel,事件选择 Deployment Created、Ready、Error。 - Netlify:在 Site Settings → Build & deploy → Deploy notifications → Outgoing webhook 中配置 URL
https://deploy-mcp.io/webhook/{username}/{repo}/netlify,事件选择 Deploy started、succeeded、failed。
注意:徽章功能要求仓库为公开仓库,私有仓库支持即将推出。
适用场景
适用于需要频繁监控部署状态、希望在不离开 AI 对话界面的情况下快速获取部署信息的开发者。特别适合同时使用多个部署平台、需要统一查看部署状态的团队或个人。
限制
- 徽章功能目前仅支持公开仓库,私有仓库支持暂未提供。
- 各平台需要配置对应的 API 令牌,且需要满足相应读取权限。
- 具体支持的令牌格式、权限要求及安装方式请以官方仓库文档为准。