vercel-mcp-server

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

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

🚀 快速开始

要使用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。