Vercel MCP Server

在现代前端开发中，Vercel 已成为部署和管理 Web 应用的核心平台之一。但项目管理、部署、域名配置、环境变量设置等繁多的操作，往往需要频繁切换到 Vercel 网页后台，打断了我们在编辑器中的开发心流。Vercel MCP Server 的出现，将这一切管理能力无缝嵌入你的 AI 开发助手（如 Cursor、Codeium 等），让你在编辑器内部就能完成 Vercel 项目的全生命周期管理。

项目基本信息

一、项目介绍

Vercel MCP Server 是一个功能极其全面的 MCP 服务器，它几乎将 Vercel 平台的所有管理能力都封装为了 MCP 工具。从项目和团队管理，到部署与域名配置，再到环境变量、边缘配置、防火墙、监控日志，甚至市场集成——总共超过 100 个 MCP 工具，覆盖了 Vercel 生态的方方面面。

核心功能模块一览

这个工具集意味着，你可以在与 AI 对话中完成从“创建项目”到“绑定域名”再到“配置环境变量并部署”的全链路操作，无需打开 Vercel 网页。

二、核心优势

全平台管理能力覆盖

这是 Vercel MCP Server 最突出的优势。它不是一个“示例级”的工具集，而是对 Vercel API 进行了极为完整的封装。从高频率使用的部署、环境变量、域名，到相对低频的团队管理、防火墙、日志排水，几乎你能在 Vercel 后台做的事情，AI 都能通过这个服务器完成。

与 Cursor 等 AI 编辑器深度集成

项目明确针对 Cursor 的 Composer 和 Codeium 的 Cascade 进行了适配。配置完成后，你只需在编辑器内用自然语言描述需求，AI 就会调用对应工具完成操作，无需离开编码环境。

精细的资源管理能力

每个功能模块都不仅提供基础的增删改查，还包含了更细粒度的操作。例如“域名”模块除了基本的列表和添加，还支持 DNS 记录管理、证书操作、域名价格查询和购买。这种粒度使其能够应对真实项目中的复杂场景。

TypeScript 实现，结构清晰

项目使用 TypeScript 编写，代码结构规范，易于理解和二次开发。对于有定制需求的团队，可以方便地修改或扩展工具集。

三、适用场景

一键部署与迭代

用户：把我当前项目部署到 Vercel，设置 Node.js 环境，添加环境变量 DATABASE_URL，然后部署到生产环境。

AI 依次调用 create_deployment、add_env、promote_deployment 等工具，完成全流程。

项目管理与协作

用户：列出我参与的所有 Vercel 项目，把“旧版官网”项目暂停，然后邀请 xxx@example.com 加入“新版官网”项目。

AI 调用 list_projects、pause_project、invite_team_member 完成操作。

域名与 DNS 配置

用户：给项目 my-blog 绑定自定义域名 blog.example.com，帮我检查域名解析状态。

AI 调用 add_domain、domain_check 等工具，完成域名配置和验证。

监控与调试

用户：帮我查看最近一次部署的日志，把日志排水配置到 Slack 通道。

AI 调用 get_deployment_events、logdrain_create 等工具，完成监控链路的搭建。

四、安装教程

环境要求

安装步骤

# 1. 克隆仓库
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server

# 2. 安装依赖
npm install

# 3. 构建项目
npm run build

获取 Vercel 访问令牌

访问 https://vercel.com/account/tokens 生成一个访问令牌，并妥善保存。

配置令牌

在 src/config/constants.ts 和 src/index.ts 中，将 YOUR_ACCESS_TOKEN 替换为你的实际令牌：

export const DEFAULT_ACCESS_TOKEN = "YOUR_ACTUAL_VERCEL_TOKEN";

配置 Cursor MCP 设置

根据你的操作系统和 Node.js 安装方式，选择对应的配置路径。

macOS:

• 默认安装: /usr/local/bin/node /path/to/vercel-mcp/dist/index.js
• Homebrew 安装: /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js
• NVM 安装: ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js

Windows:

• 默认安装: C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js
• NVM 安装: C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js

Linux:

• 默认安装: /usr/bin/node /path/to/vercel-mcp/dist/index.js
• NVM 安装: ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js

使用 which node（macOS/Linux）或 where node（Windows）可以查找你本机的 Node.js 路径。

调试模式

如果遇到问题，可以启用调试模式查看详细日志：

# macOS/Linux
DEBUG=true /usr/local/bin/node /path/to/vercel-mcp/dist/index.js

# Windows
set DEBUG=true && "C:\Program Files\nodejs\node.exe" "C:\path\to\vercel-mcp\dist\index.js"

五、使用示例

配置完成后，在 Cursor 的 Composer 中即可用自然语言操作：

示例一：查看项目列表

用户：列出我所有的 Vercel 项目。

AI 调用 list_projects 工具，返回你的项目名称、状态和最新部署信息。

示例二：部署项目并设置环境变量

用户：部署当前项目到生产环境，设置环境变量 API_URL=https://api.example.com。

AI 调用 create_deployment 完成部署，再调用 add_env 添加环境变量。

示例三：绑定自定义域名

用户：给我的项目 my-app 绑定 www.myapp.com，检查一下域名的 DNS 配置是否正确。

AI 调用 add_domain 绑定域名，再调用 domain_check 检查 DNS 指向状态。

示例四：配置防火墙规则

用户：帮我查看当前项目的防火墙配置，添加一条旁路规则允许 IP 203.0.113.1 访问。

AI 调用 get_firewall_config 查看当前配置，再调用 create_firewall_bypass 添加规则。

六、常见问题

问：配置完成后，Cursor 中看不到 Vercel 工具怎么办？

答：请按以下步骤排查：

1. 检查构建：确认 npm run build 是否成功完成，dist/index.js 是否存在。
2. 检查令牌：确认访问令牌是否正确填入代码中。
3. 刷新 MCP：在 Cursor 的 MCP 设置中点击“刷新”按钮。
4. 检查路径：使用 which node 获取正确的 Node.js 路径，确保配置中使用的路径与实际一致。
5. 启用调试：使用 DEBUG=true 模式启动，查看详细日志。

问：访问令牌应该配置在哪里？安全吗？

答：当前版本需要将令牌配置在源代码中。这意味着：

1. 不要将包含真实令牌的代码提交到公开仓库。
2. 如果你 fork 或贡献代码，先清除令牌再提交。
3. 建议在 Vercel 中为 MCP 服务器创建一个权限受限的专用令牌。

问：支持哪些 AI 客户端？

答：该项目主要针对 Cursor 和 Codeium 进行了适配和使用。其他支持 MCP 的客户端理论上也可以使用，但需要自行配置。

问：工具数量太多，AI 会不会选错？

答：这是一个值得注意的问题。Vercel MCP Server 提供的工具超过 100 个，在某些情况下 AI 可能会混淆类似功能的工具。建议在使用时给出明确的自然语言描述，帮助 AI 正确选择工具。

问：Vercel 令牌过期了怎么办？

答：访问 https://vercel.com/account/tokens 重新生成一个令牌，然后更新配置文件中的 DEFAULT_ACCESS_TOKEN，重新构建项目即可。

七、总结

Vercel MCP Server 是目前 MCP 生态中对 Vercel 平台覆盖最全面的管理工具。它将 Vercel 后台的几乎所有操作能力带入了 AI 开发环境，让你在编辑器内就能完成项目全生命周期的管理。对于重度使用 Vercel 的前端开发者和团队来说，这是一个能显著减少上下文切换、提升工作效率的利器。

花十分钟完成安装配置，接下来你只需用日常语言告诉 AI 你想做什么，它会帮你完成剩余的所有 Vercel 操作。