Vercel MCP Server

用于集成Vercel API的MCP（模型上下文协议）服务器，提供项目管理、部署管理、环境变量管理和域名管理等功能。

功能

基本功能

• 项目管理：获取项目列表和详细信息
• 部署管理：获取部署列表、详情、取消部署、获取日志
• 环境变量管理：检索、创建、更新和删除环境变量
• 域名管理：检索域名列表、添加/删除域名

高优先级功能

• 运行时日志：检索并流式传输应用程序运行时日志
• 构建日志：检索并流式传输构建过程日志
• Webhook管理：创建、更新、删除和查询Webhook配置
• 团队管理：管理团队成员、权限和团队信息
• 分析监控：获取性能指标、使用统计和分析数据

低优先级功能

• 访问控制：管理访问组和权限控制
• 审计日志：检索并流式传输审计日志
• Token管理：创建、删除和查询API Tokens
• 高级部署功能：部署推广、回滚、别名管理

技术特性

• 完整的错误处理和日志记录
• 支持TypeScript
• 流式数据传输
• 统一的API响应格式

安装与配置

1. 克隆项目并安装依赖

git clone <repository-url>
cd vercel-mcp-server
npm install

2. 构建项目

npm run build

3. 获取Vercel API Token

1. 访问 Vercel仪表板
2. 转到设置 > 令牌
3. 创建一个新的API Token
4. 复制生成的token

4. 在Trae中配置MCP服务器

在Trae的MCP配置中添加以下JSON配置：

方法1：使用NPX（推荐）

{
  "mcpServers": {
    "vercel": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=file:E:\\GIT_CODE\\mcp\\vercel-mcp-server",
        "vercel-mcp-server"
      ],
      "env": {
        "VERCEL_TOKEN": "your_vercel_api_token_here",
        "LOG_LEVEL": "info"
      }
    }
  }
}

方法2：使用node命令（替代方案）

{
  8"mcpServers": {
    "vercel": {
      "command": "node",
      "args": [
        "E:\\GIT_CODE\\mcp\\vercel-mcp-server\\dist\\index.js"
      ],
      "env": {
        "VERCEL_TOKEN": "your_vercel_api_token_here",
        "LOG_LEVEL": "info"
      }
    }
  }
}

重要提示：

• 将 E:\\GIT_CODE\\mcp\\vercel-mcp-server 替换为您的实际项目路径
• 将 your_vercel_api_token_here 替换为您的实际Vercel API Token
• 确保项目已经构建（运行 npm run build）

配置参数描述

• VERCEL_TOKEN：Vercel API访问令牌（必需）
• VERCEL_TEAM_ID：Vercel团队ID（可选，用于团队项目）
• LOG_LEVEL：日志级别（可选，默认为info）
• API_TIMEOUT：API请求超时时间，以毫秒为单位（可选，默认为30000）

可用的MCP工具

基本功能工具

项目管理

• vercel_list_projects：获取项目列表
• vercel_get_project：获取项目详细信息

部署管理

• vercel_list_deployments：获取部署列表
• vercel_get_deployment：获取部署详情
• vercel_cancel_deployment：取消部署
• vercel_get_deployment_logs：检索部署日志

环境变量管理

• vercel_list_env_vars：检索环境变量列表
• vercel_create_env_var：创建环境变量
• vercel_update_env_var：更新环境变量
• vercel_delete_env_var：删除环境变量

域名管理

• vercel_list_domains：获取域名列表
• vercel_add_domain：添加域名
• vercel_delete_domain：删除域名

高优先级功能工具

运行时日志

• vercel_get_runtime_logs：检索运行时日志
• vercel_stream_runtime_logs：流式传输运行时日志

构建日志

• vercel_get_build_logs：获取构建日志
• vercel_stream_build_logs：流式传输构建日志

Webhook管理

• vercel_list_webhooks：获取Webhook列表
• vercel_create_webhook：创建Webhook
• vercel_update_webhook：更新Webhook
• vercel_delete_webhook：删除Webhook
• vercel_get_webhook：获取Webhook详情

团队管理

• vercel_list_teams：获取团队列表
• vercel_get_team：获取团队详情
• vercel_list_team_members：获取团队成员列表
• vercel_add_team_member：添加团队成员
• vercel_remove_team_member：移除团队成员
• vercel_update_team_member：更新团队成员

分析监控

• vercel_get_analytics：获取分析数据
• vercel_get_performance_metrics：获取性能指标
• vercel_get_usage_stats：获取使用统计

低优先级功能工具

访问控制

• vercel_list_access_groups：获取访问组列表
• vercel_create_access_group：创建访问组
• vercel_update_access_group：更新访问组
• vercel_delete_access_group：删除访问组

审计日志

• vercel_get_audit_logs：获取审计日志
• vercel_stream_audit_logs：流式传输审计日志

Token管理

• vercel_list_tokens：获取Token列表
• vercel_create_token：创建Token
• vercel_delete_token：删除Token
• vercel_get_token_info：获取Token信息

高级部署功能

• vercel_promote_deployment：推广部署
• vercel_rollback_deployment：回滚部署
• vercel_create_alias：创建别名
• vercel_delete_alias：删除别名

故障排除

常见错误及解决方案

1. MCP错误 -32000: 连接关闭

   • 这是一个正常现象！MCP服务器通过STDio与客户端通信
   • 直接运行 node dist/index.js 会立即退出，因为没有MCP客户端连接
   • 只有在配置了如Trae这样的MCP客户端后才能正常工作
   • 如果在Trae中仍然出现此错误，请检查：
     • 是否正确设置了VERCEL_TOKEN环境变量
     • 项目是否已正确构建（npm run build）
     • 配置路径是否正确

2. 'vercel mcp server' 不是内部或外部命令

   • 确保项目已构建：npm run build
   • 检查packagejson中是否有bin字段
   • 尝试使用方法二（node命令）

3. ENOENT 错误

   • 检查配置中的路径是否正确
   • 确保使用绝对路径
   • 确保dist/index.js文件存在

4. API认证错误

   • 检查VERCEL_TOKEN是否正确
   • 确保token具有足够的权限
   • 检查token是否已过期

开发

# 开发模式
npm run dev

# 运行测试
npm test

# 代码检查
npm run lint

# 代码格式化
npm run format

许可证

MIT许可证