SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场vercel-automation

vercel-automation

部署与运维

查看项目

更新于 10-15 10:24

技能介绍

用途

Vercel Automation 是一个通过 Rube MCP（基于 Composio 的 Vercel 工具包）来自动化 Vercel 平台操作的技能。它面向需要以编程或代理方式管理 Vercel 部署、域名、DNS、环境变量、项目和团队的任务场景。

主要能力

1. 监控与检查部署

用于列出、检查或调试部署。工具序列：VERCEL_LIST_ALL_DEPLOYMENTS 或 VERCEL_GET_DEPLOYMENTS 列出部署（必需）；VERCEL_GET_DEPLOYMENT 或 VERCEL_GET_DEPLOYMENT_DETAILS 获取指定部署信息（可选）；VERCEL_GET_DEPLOYMENT_LOGS 或 VERCEL_GET_RUNTIME_LOGS 查看构建/运行时日志（可选）；VERCEL_GET_DEPLOYMENT_EVENTS 获取部署事件时间线（可选）；VERCEL_LIST_DEPLOYMENT_CHECKS 查看部署检查结果（可选）。关键参数：projectId、state（如 READY、ERROR、BUILDING）、limit、target（production、preview）、deploymentId 或 idOrUrl。注意：多数端点同时接受部署 ID 和 URL；构建日志与运行时日志是分开的；部署事件包含状态转换，适合调试时序问题。

2. 创建与管理部署

用于触发新部署。工具序列：VERCEL_LIST_PROJECTS 查找目标项目（前提）；VERCEL_CREATE_NEW_DEPLOYMENT 触发新部署（必需）；VERCEL_GET_DEPLOYMENT 监控部署进度（可选）。关键参数：name、target、gitSource、files。注意：gitSource 和 files 二者只能提供一个；Git 部署需要正确的仓库集成；生产部署会自动更新生产域名别名；部署创建是异步的，需轮询 GET_DEPLOYMENT 获取状态。

3. 管理环境变量

用于添加、列出或删除项目环境变量。工具序列：VERCEL_LIST_PROJECTS 查找项目 ID（前提）；VERCEL_LIST_ENV_VARIABLES 列出已有环境变量（必需）；VERCEL_ADD_ENVIRONMENT_VARIABLE 添加（可选）；VERCEL_DELETE_ENVIRONMENT_VARIABLE 删除（可选）。关键参数：projectId、key、value、target（production、preview、development）、type（plain、secret、encrypted、sensitive）。注意：变量名在每个目标环境中必须唯一；secret 类型变量创建后无法读回，只返回 ID；删除需要 projectId 和变量 id（而非键名）；更改后需重新部署才生效。

4. 管理域名与 DNS

用于配置自定义域名或管理 DNS 记录。工具序列：VERCEL_GET_DOMAIN 检查域名状态（必需）；VERCEL_GET_DOMAIN_CONFIG 获取 DNS/SSL 配置（可选）；VERCEL_LIST_PROJECT_DOMAINS 列出项目关联域名（可选）；VERCEL_GET_DNS_RECORDS、VERCEL_CREATE_DNS_RECORD、VERCEL_UPDATE_DNS_RECORD（可选）。关键参数：domain、name、type（A、AAAA、CNAME、MX、TXT、SRV）、value、ttl。注意：域名须先添加到 Vercel 账户；SSL 证书自动配置但新域名可能需要时间；根域名不支持 CNAME，应使用 A 记录；MX 记录需要优先级值。

5. 管理项目

用于列出、检查或更新项目设置。工具序列：VERCEL_LIST_PROJECTS（必需）；VERCEL_GET_PROJECT 获取详情（可选）；VERCEL_UPDATE_PROJECT 修改设置（可选）。关键参数：idOrName、name、framework（如 nextjs、vite、remix）、buildCommand、rootDirectory。注意：项目名在团队/账户内全局唯一；更改框架设置会影响后续部署；rootDirectory 相对于仓库根目录。

6. 团队管理

用于查看团队信息或列出成员。工具序列：VERCEL_LIST_TEAMS、VERCEL_GET_TEAM、VERCEL_GET_TEAM_MEMBERS。关键参数：teamId、limit、role。注意：团队操作需要相应的团队级权限；个人账户没有团队，团队端点返回空结果；成员角色包括 OWNER、MEMBER、DEVELOPER、VIEWER。

使用方式

先决条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；通过 RUBE_MANAGE_CONNECTIONS 使用工具包 vercel 建立活跃的 Vercel 连接；始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

设置步骤：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥，只需添加端点即可工作；确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用；调用 RUBE_MANAGE_CONNECTIONS 并指定工具包 vercel；如果连接不是 ACTIVE，按返回的认证链接完成 Vercel OAuth；确认连接状态为 ACTIVE 后再运行任何工作流。

适用场景

  • 需要批量或自动化列出、检查、调试 Vercel 部署的开发和运维任务。
  • 以程序化方式触发生产和预览环境部署。
  • 管理项目环境变量并区分不同环境与类型。
  • 配置自定义域名、查看域名配置和管理 DNS 记录。
  • 查看和更新项目框架、构建命令、根目录等设置。
  • 查看团队信息与成员列表。

限制与注意事项

  • 必须先连接 Rube MCP 并激活 Vercel 连接（状态 ACTIVE）才能执行工作流。
  • 始终先调用 RUBE_SEARCH_TOOLS 以获取当前工具架构。
  • 部署状态包括：INITIALIZING、ANALYZING、BUILDING、DEPLOYING、READY、ERROR、CANCELED、QUEUED；只有 READY 部署正在提供服务；ERROR 部署应通过日志检查失败详情。
  • secret 类型环境变量为只写，创建后无法获取值；环境变量按环境作用域划分；更改后需要重新部署才生效。
  • Vercel API 各端点有速率限制，遇到 429 响应应实施退避；尽量批量操作以减少 API 调用。
  • 根域名不支持 CNAME 记录，应使用 A 记录；MX 记录需要优先级值。
  • 团队操作需要相应团队级权限；个人账户没有团队。
  • 项目名称在团队/账户内全局唯一。
  • 部署创建为异步操作，需要轮询获取状态。
  • 关于收费、价格、具体平台效果等信息，资料中暂未提供。