vercel

本地服务

github.com/pulsemcp云与基础设施818 周前更新

代码仓库

关于 vercel

Vercel 的 MCP 服务，通过 Vercel REST API 管理部署并查看构建日志与运行时应用日志。适合需要在 MCP 客户端内排查部署问题的开发者和团队。

主要功能

01部署列表、详情、创建、取消、删除、提升与回滚
02构建日志（events）查询
03运行时应用日志过滤
04通过环境变量启用 readonly 或 readwrite 工具组
05可限定到指定 Vercel 团队范围

适用场景

01查看最近部署的状态并找出失败或进行中的部署
02读取构建日志以定位构建错误
03将预览部署提升为生产环境并回滚到之前的版本
04按状态码或级别筛选运行时错误日志

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 Vercel 部署与日志相关的工具。设置 VERCEL_ENABLED_TOOLGROUPS=readonly 可禁用所有写操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-pulsemcp-vercel": {
      "command": "npx",
      "args": [
        "-y",
        "vercel-platform-mcp-server"
      ],
      "env": {
        "VERCEL_TOKEN": "<VERCEL_TOKEN>",
        "VERCEL_TEAM_ID": "<VERCEL_TEAM_ID>",
        "VERCEL_TEAM_SLUG": "<VERCEL_TEAM_SLUG>",
        "VERCEL_ENABLED_TOOLGROUPS": "<VERCEL_ENABLED_TOOLGROUPS>"
      }
    }
  }
}

启动命令npx -y vercel-platform-mcp-server

需要配置的环境变量

VERCEL_TOKEN密钥Vercel API token for authentication.

VERCEL_TEAM_IDTeam ID for team-scoped operations.

VERCEL_TEAM_SLUGTeam URL slug for team-scoped operations.

VERCEL_ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly, readwrite).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmvercel-platform-mcp-server0.1.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
app	string	否	按部署名称筛选（即 URL 中使用的项目名称）。示例：“my-app”
limit	number	否	返回的部署数量上限（1–100）。默认值：20。与分页配合使用以逐页获取结果。
state	enum	否	按部署状态筛选。选项："BUILDING"、"ERROR"、"INITIALIZING"、"QUEUED"、"READY"、"CANCELED"。省略则返回任意状态的部署。BUILDING \| ERROR \| INITIALIZING \| QUEUED \| READY \| CANCELED
until	number	否	返回在此时间戳之前创建的部署（自纪元以来的毫秒数）。用于分页：传入上一次响应中的 "next" 值。
target	enum	否	按部署目标环境筛选。选项："production"、"preview"。省略则返回所有目标环境的部署。production \| preview
projectId	string	否	按项目 ID 或名称筛选（例如："prj_abc123" 或 "my-app"）。设置后仅返回此项目的部署。

详细介绍

Vercel MCP 服务

一个用于通过 Vercel REST API 管理 Vercel 部署并查看应用程序运行时日志的 MCP 服务。

亮点

部署管理 - 列出、检查、创建、取消、删除、提升和回滚部署
构建与运行时日志 - 查看构建日志（事件）和应用程序运行时日志，以便调试
精细的访问控制 - 通过环境变量启用只读或读写工具组
团队支持 - 将操作限定在指定的 Vercel 团队

功能

工具

工具	组	描述
`list_deployments`	只读	列出部署，可按项目、目标和状态筛选
`get_deployment`	只读	按 ID 或 URL 获取详细的部署信息
`list_projects`	只读	列出账户或团队中的项目
`get_deployment_events`	只读	获取部署的构建日志
`get_runtime_logs`	只读	获取可筛选的应用程序运行时日志
`create_deployment`	读写	创建新部署或重新部署
`cancel_deployment`	读写	取消正在进行的部署
`delete_deployment`	读写	永久删除部署
`promote_deployment`	读写	将部署提升到生产环境
`rollback_deployment`	读写	回滚到之前的部署

设置

前置条件

拥有 API 令牌的 Vercel 账户（在此创建）
Node.js 18+

配置

变量	必需	描述
`VERCEL_TOKEN`	是	Vercel API 令牌
`VERCEL_TEAM_ID`	否	用于限定团队操作的团队 ID
`VERCEL_TEAM_SLUG`	否	团队 URL 别名（团队 ID 的替代选项）
`VERCEL_ENABLED_TOOLGROUPS`	否	以逗号分隔的工具组：`readonly`、`readwrite`（默认：全部）

手动设置

# Clone the repository
git clone https://github.com/pulsemcp/mcp-servers.git
cd mcp-servers/experimental/vercel

# Install dependencies
npm install

# Build
npm run build

# Set environment variables
export VERCEL_TOKEN="your-token-here"

# Run
npm start

使用提示

先使用 list_projects 查找 promote_deployment、rollback_deployment 和 get_runtime_logs 所需的项目 ID
运行时日志的保留时间因套餐而异：Hobby=1h、Pro=1d、Enterprise=3d（使用 Observability Plus 时最长可达 30d）
使用 get_runtime_logs 配合 since/until 查询历史日志，配合 search 查找特定错误，并配合 level/source 筛选结果
设置 VERCEL_ENABLED_TOOLGROUPS=readonly，以禁止所有写入操作
使用 list_deployments 配合 state 筛选器，快速查找失败或正在进行的部署

示例

检查部署状态

“我最新的部署是什么状态？”

使用 list_deployments 显示近期部署及其状态。

调试构建失败

“显示部署 dpl_abc123 的构建日志”

使用 get_deployment_events 显示构建输出和错误消息。

将预览部署提升到生产环境

“将项目 prj_xyz789 的部署 dpl_abc123 提升到生产环境”

使用 promote_deployment，让预览部署开始承载生产流量。

查看运行时错误

“显示 my-app 最新部署的运行时日志”

使用 list_projects 查找项目 ID，然后使用 get_runtime_logs 显示近期应用程序日志。

搜索日志中的特定错误

“查找 my-app 在过去 24 小时内的所有 500 错误”

使用 get_runtime_logs，将 statusCode: 500 和 since 设置为 24 小时前，以筛选服务器错误。

调试边缘函数问题

“显示 dpl_abc123 的边缘函数警告和错误日志”

使用 get_runtime_logs，通过 source: "edge-function" 和 level: "error" 缩小问题范围。

开发

# Install dependencies
npm install

# Build
npm run build

# Run functional tests
npm test

# Run integration tests
npm run test:integration

# Run manual tests (requires .env with VERCEL_TOKEN)
npm run test:manual

# Lint
npm run lint

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。