Vercel MCP Server

🚀 Vercel管理控制台（MCP）配置指南

本指南将详细介绍如何配置和使用Vercel管理控制台（MCP），帮助你轻松管理Vercel项目。

🚀 快速开始

按照以下步骤完成Vercel管理控制台（MCP）的配置，即可使用相关管理工具。

📦 安装指南

要使用Vercel管理工具，请按照以下步骤进行：

1. 获取访问令牌
   • 登录Vercel官网。
   • 进入“用户设置”>“安全”>“访问令牌”。
   • 创建并复制一个新的访问令牌。
2. 配置MCP服务器
   • 将复制的访问令牌粘贴到config.json文件中。
   • 确保文件路径为：vercel-mcp/config.json。

   {
     "token": "your-vercel-token"
   }
   

3. 启动服务
   • 打开终端，导航到vercel-mcp目录。
   • 运行命令：

   node index.js
   

   • 服务器将在http://localhost:4001启动。

💻 使用示例

基础用法

完成配置后，MCP服务器将提供所有Vercel管理工具。通过Cursor的Composer描述您需要执行的操作，AI将自动调用相应的命令。

高级用法

以下是一些常见操作的示例场景：

• 查询项目列表：输入“列出我的所有项目”。
• 创建新项目：输入“创建一个新的Next.js项目”。
• 绑定：输入“为项目添加自定义域名”。
• 环境变量管理：输入“设置环境变量”。

⚠️ 安全提示

• 令牌安全：确保访问令牌仅用于可信网络环境。
• 权限控制：限制令牌的使用范围和有效期。
• 日志监控：定期检查操作日志，发现异常及时处理。

🛠️ 故障排查

常见问题

1. Node.js路径错误
   • 确认系统中已安装Node.js。
   • 使用命令node --version检查版本。
   • 使用命令which node（mac/Linux）或where node（Windows）确认路径。
2. 令牌失效
   • 检查令牌是否过期。
   • 确保令牌具备所需权限。
   • 如需重新生成，请访问Vercel官网。
3. 工具未识别
   • 在Cursor的MCP设置中点击“刷新”按钮。
   • 确认服务器运行状态（无错误提示）。
   • 验证Vercel凭证是否正确。

调试模式

在命令前添加DEBUG=true以显示详细日志：

# mac/Linux
DEBUG=true node index.js

# Windows
set DEBUG=true & node index.js

如仍无法解决问题，请提供以下信息：

• 操作系统版本。
• Node.js版本。
• 具体错误信息。
• 问题复现步骤。

🤝 贡献指南

欢迎贡献！请随意提交修复或改进的Pull Request。