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

本项目为 Cursor 提供了 Vercel 管理工具，通过配置 MCP 服务器，可方便地对 Vercel 项目进行管理操作。

🚀 快速开始

按照以下步骤完成 Vercel 管理命令接口（MCP）的安装与配置：

📦 安装指南

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

⚠️ 安全注意事项

1. 保持令牌安全

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

2. 权限控制

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

3. 遵循最佳实践

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

🛠️ 故障排除

常见问题

1. Node.js 路径问题

确保使用正确的 Node.js 路径：

• Mac/Linux：使用 which node 查找路径。
• Windows：使用 where node 查找路径。

2. 令牌无效

验证 Vercel 访问令牌的有效性，确保其未过期且具有必要的权限。

3. MCP 无法识别工具

• 在 Cursor 的 MCP 设置中点击刷新按钮。
• 确保服务器正常运行（无错误信息）。
• 检查 Vercel 凭据是否有效。

调试模式

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

# Mac/Linux
DEBUG=true npm start

# Windows
set DEBUG=true && npm start

🤝 贡献指南

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