Quegenx Vercel MCP Server

🚀 Vercel 管理命令接口（MCP）安装指南

本项目的 Vercel 管理命令接口（MCP），为 Cursor 提供了便捷的 Vercel 管理工具。通过该接口，用户可以方便地对 Vercel 项目进行各种操作，提升项目管理效率。

🚀 快速开始

本部分将引导你完成 Vercel 管理命令接口（MCP）的安装与配置，让你能迅速使用该接口管理 Vercel 项目。

📦 安装指南

1. 下载并安装 Node.js

确保你已安装 Node.js，推荐使用 LTS 版本。

2. 克隆 MCP 仓库

打开终端，运行以下命令：

git clone https://github.com/Quegenx/cursor-vercel-mcp.git

3. 安装依赖项

进入仓库目录，运行：

npm install

4. 启动 MCP 服务

安装完成后，运行以下命令启动服务：

npm start

5. 配置 Vercel 访问令牌

在 Cursor 的 MCP 设置中，添加你的 Vercel 访问令牌以完成身份验证。

📚 详细文档

配置指南

初始化 MCP 服务器

在终端运行以下命令启动 MCP 服务：

npm start

访问令牌配置

将 VERCEL_ACCESS_TOKEN 环境变量添加到你的项目中，确保其安全。

使用说明

一旦配置完成，MCP 服务器将为 Cursor 提供所有 Vercel 管理工具。只需描述你想对 Vercel 项目执行的操作，AI 即会使用相应的命令进行处理。

💻 使用示例

基础用法

列出所有项目

vercel projects list

创建新项目

vercel projects create --name my-next-project --type nextjs

添加自定义域名

vercel domains add mydomain.com -p projectId

设置环境变量

vercel envs create PROJECT_ID VARIABLE_NAME=variable_value

⚠️ 安全注意事项

保持令牌安全

确保 Vercel 访问令牌的安全性，避免泄露。

权限控制

使用适当的访问控制策略，限制令牌的使用范围和权限。

遵循最佳实践

遵循 Vercel 的安全建议，定期审查和更新你的配置。

🔧 技术细节

故障排除

常见问题

• Node.js 路径问题
  • 确保使用正确的 Node.js 路径。
  • Mac/Linux：使用 which node 查找路径。
  • Windows：使用 where node 查找路径。
• 令牌无效
  • 验证 Vercel 访问令牌的有效性，确保其未过期且具有必要的权限。
• MCP 无法识别工具
  • 在 Cursor 的 MCP 设置中点击刷新按钮。
  • 确保服务器正常运行（无错误信息）。
  • 检查 Vercel 凭据是否有效。

调试模式

在命令前添加 DEBUG=true 以启用详细日志输出：

# Mac/Linux
DEBUG=true npm start

# Windows
set DEBUG=true && npm start

🤝 贡献指南

欢迎贡献！请随意提交 Pull Request。