mcpField
V
vercel

vercel

github.com/acedatacloud云与 DevOps17167 次安装今天更新
代码仓库

关于 vercel

使用 curl 和 jq 调用 Vercel REST API 的命令行技能，涵盖项目与部署检查、构建诊断和域名查看，并提醒保护环境变量及确认生产环境重新部署。

主要功能

  1. 01列出项目和部署
  2. 02查看部署状态与详情
  3. 03读取构建和运行时日志
  4. 04检查项目域名
  5. 05处理团队范围的 API 请求

适用场景

  1. 01查看近期部署
  2. 02诊断构建失败
  3. 03检查域名验证状态
  4. 04查看项目部署状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill vercel

安装后在 Claude Code 中输入/vercel确认已加载。

详细介绍

使用 curl + jq 调用 Vercel REST API。用户的令牌位于 $VERCEL_ACCESS_TOKEN；每次调用都需要 Authorization: Bearer $VERCEL_ACCESS_TOKEN。基础 URL：https://api.vercel.com。如果资源 限定于团队，请追加 ?teamId=$VERCEL_TEAM_ID（仅当用户连接了团队令牌时才设置）。

错误以 {"error":{"code","message"}} 的形式返回——原样显示 message。 403 forbidden 通常表示令牌无权查看该团队或项目 → 使用正确的范围重新连接。

可选团队参数的辅助代码：

TEAM=""; [ -n "$VERCEL_TEAM_ID" ] && TEAM="?teamId=$VERCEL_TEAM_ID"
AUTH="Authorization: Bearer $VERCEL_ACCESS_TOKEN"

项目与部署

# Projects
curl -sS -H "$AUTH" "https://api.vercel.com/v9/projects$TEAM" \
  | jq '.projects[] | {name, framework, latestProduction: .latestDeployments[0].url}'

# Recent deployments (optionally filter by ?projectId=… or &state=ERROR)
curl -sS -H "$AUTH" "https://api.vercel.com/v6/deployments${TEAM:-?}&limit=20" \
  | jq '.deployments[] | {uid, name, url, state, readyState, created}'

诊断构建失败

# Deployment detail
curl -sS -H "$AUTH" "https://api.vercel.com/v13/deployments/DEPLOYMENT_ID${TEAM:+&teamId=$VERCEL_TEAM_ID}" \
  | jq '{name, url, state: .readyState, error: .errorMessage}'

# Build / runtime events (the actual logs)
curl -sS -H "$AUTH" "https://api.vercel.com/v3/deployments/DEPLOYMENT_ID/events${TEAM:+?teamId=$VERCEL_TEAM_ID}" \
  | jq -r '.[] | select(.type=="stdout" or .type=="stderr") | .payload.text'

域名与重新部署

# Project domains
curl -sS -H "$AUTH" "https://api.vercel.com/v9/projects/PROJECT_ID/domains${TEAM:+?teamId=$VERCEL_TEAM_ID}" \
  | jq '.domains[] | {name, verified}'

要重新部署，请向 https://api.vercel.com/v13/deployments 发送 POST 请求，并在请求体中提供 deploymentId（或 Git 来源）——请先与用户确认，因为这会将内容发布到生产环境。

注意事项

  • 绝不打印环境变量的值。 列出项目环境变量会返回元数据； /v1/.../env/{id} 解密路由会返回密钥——除非用户明确要求，否则不要调用；即使用户要求，也要进行概述，不要原样输出。
  • 部署的 state/readyState：QUEUED → BUILDING → READY | ERROR | CANCELED。
  • created/ready 是纪元毫秒时间戳——除以 1000 即可转换为人类可读的时间。

评论

支持 Markdown