SuperAPI AI 工具集

deploy-mcp

deploy-mcp 是一个通用部署追踪工具,面向 AI 助手设计。它让开发者在 AI 对话中直接查看各平台部署状态,无需切换窗口或打开仪表板。支持 Vercel、Netlify、Cloudflare Pages 等多个部署平台,并可为仓库提供实时部署状态徽章。

访问官网

工具介绍

用途

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 令牌,且需要满足相应读取权限。
  • 具体支持的令牌格式、权限要求及安装方式请以官方仓库文档为准。