Crav MCP Vercel

Vercel MCP服务器

Vercel部署自动化的模型上下文协议（MCP）服务器。使Javari AI能够自主部署应用程序、监控构建和管理Vercel资源。

特性

• ✅ 触发部署（预览和生产）
• ✅ 实时监控构建状态
• ✅ 检索部署日志
• ✅ 解析构建错误
• ✅ 将预览推广到生产
• ✅ 取消失败的部署
• ✅ 管理环境变量
• ✅ 配置域
• ✅ 列出所有项目
• ✅ 安全的API密钥身份验证
• ✅ 综合录井

安装

npm install

配置

复制 .env.example 到 .env 并配置：

cp .env.example .env

所需变量：

• VERCEL_TOKEN：具有部署权限的Vercel访问令牌
• MCP_API_KEY：MCP身份验证的安全密钥

发展

npm run dev

生产

npm run build
npm start

API终点

健康检查

GET /health

触发器部署

POST /api/deploy
Headers: x-api-key: YOUR_MCP_KEY
Body: {
  "name": "my-app",
  "gitSource": {
    "type": "github",
    "repo": "CR-AudioViz-AI/my-repo",
    "ref": "main"
  },
  "framework": "nextjs",
  "envVariables": [
    { "key": "API_KEY", "value": "secret" }
  ]
}

获取部署状态

GET /api/deploy/:id/status
Headers: x-api-key: YOUR_MCP_KEY

获取部署日志

GET /api/deploy/:id/logs
Headers: x-api-key: YOUR_MCP_KEY

获取构建错误

GET /api/deploy/:id/errors
Headers: x-api-key: YOUR_MCP_KEY

推广到生产

POST /api/deploy/:id/promote
Headers: x-api-key: YOUR_MCP_KEY

取消部署

DELETE /api/deploy/:id
Headers: x-api-key: YOUR_MCP_KEY

列出项目

GET /api/projects
Headers: x-api-key: YOUR_MCP_KEY

设置环境变量

POST /api/env
Headers: x-api-key: YOUR_MCP_KEY
Body: {
  "projectId": "prj_xxx",
  "env": {
    "API_KEY": "value",
    "DATABASE_URL": "postgres://..."
  }
}

配置域

POST /api/projects/:id/domain
Headers: x-api-key: YOUR_MCP_KEY
Body: {
  "domain": "myapp.com"
}

安全

• 所有终结点（health除外）都需要API密钥身份验证
• 速率限制：每个IP每小时1000个请求
• Vercel令牌安全地存储在环境变量中
• 所有操作的审核日志记录

部署

铁路（推荐）

railway up

在Railway仪表板中配置环境变量。

码头工人

docker build -t crav-mcp-vercel .
docker run -p 3002:3002 --env-file .env crav-mcp-vercel

监控

检查服务器运行状况：

curl http://localhost:3002/health

错误处理

所有端点返回一致的错误格式：

{
  "error": "Error description",
  "details": "Detailed message from Vercel API"
}

部署状态

• INITIALIZING：正在准备部署
• BUILDING：代码正在构建中
• DEPLOYING：正在部署构建代码
• READY：部署是实时且可访问的
• ERROR：部署失败
• CANCELED：部署已取消

日志

• combined.log：所有操作
• error.log：仅错误
• 控制台：实时彩色输出

许可证

麻省理工学院-CR AudioViz AI