Vercel MCP Server 🚀

Vercel MCP Server 🚀

🔥 一款功能强大的 Model Context Protocol（MCP）服务，可通过 Cursor 的 Composer 和 Codeium 的 Cascade 对 Vercel 部署进行全面管理。此工具提供部署、域名、环境变量等全面功能，助您轻松管理项目。

📚 目录

• 先决条件
• 快速开始
• 集成
• 功能
• 使用方法
• 安全说明
• 故障排除
• 参与贡献
• 许可证

🔧 先决条件

• Node.js >= 16.x
• npm >= 8.x
• Vercel 账户，需具备：
  • 访问令牌
  • 团队 ID（可选）
  • 项目 ID（可选）
• Cursor IDE 或 Codeium 的 Cascade（付费用户适用）

🚀 快速开始

📥 安装

# Clone the repository
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 配置

1. 安装依赖并构建项目：

   npm install
   npm run build
   

2. 设置 Vercel 访问令牌：

   • 前往 https://vercel.com/account/tokens 生成访问令牌

   • 在以下两个文件中更新令牌：

     在 src/config/constants.ts 中：

     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
     

     在 src/index.ts 中：

     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
     

3. 在 Cursor 的 MCP 设置中，使用以下命令添加服务：

   macOS：

   # Default installation
   /usr/local/bin/node /path/to/vercel-mcp/dist/index.js
   
   # Homebrew installation
   /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js
   
   # NVM installation
   ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   

   Windows：

   # Default installation
   C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js
   
   # NVM for Windows
   C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js
   
   # Scoop installation
   C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
   

   Linux：

   # Default installation
   /usr/bin/node /path/to/vercel-mcp/dist/index.js
   
   # NVM installation
   ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   

   将 /path/to/vercel-mcp 或 C:\path\to\vercel-mcp 替换为实际的安装路径。

   查找 Node.js 路径：

   # macOS/Linux
   which node
   
   # Windows
   where node
   

注意：请妥善保管 Vercel 访问令牌，切勿将其提交到版本控制系统。

🎯 功能

🎯 可用工具

团队管理

• 团队：create_team、delete_team、get_team、list_teams、update_team
• 团队成员：list_team_members、invite_team_member、remove_team_member、update_team_member

项目管理

• 项目：list_projects、create_project、delete_project、update_project、pause_project
• 项目成员：add_project_member、list_project_members、remove_project_member
• 项目转移：request_project_transfer、accept_project_transfer

部署管理

• 部署：create_deployment、cancel_deployment、get_deployment、delete_deployment、list_deployment
• 部署事件：get_deployment_events、update_deployment_integration
• 部署文件：list_deployment_files、upload_deployment_files、get_deployment_file
• 部署推广：promote_deployment、get_promotion_aliases

域名与 DNS 管理

• 域名：add_domain、remove_domain、get_domain、list_domains、get_project_domain
• 域名操作：domain_check、domain_price、domain_config、domain_registry、domain_get、domain_list、domain_buy、domain_register、domain_remove、domain_update
• DNS：create_dns_record、delete_dns_record、list_dns_records、update_dns_record
• 证书：get_cert、issue_cert、remove_cert、upload_cert

环境与配置

• 环境变量：add_env、update_env、delete_env、get_env、list_env
• Edge Config：create_edge_config、update_edge_config、delete_edge_config、get_edge_config、list_edge_configs
• Edge Config 项：list_edge_config_items、get_edge_config_item、update_edge_config_items
• Edge Config 架构：get_edge_config_schema、update_edge_config_schema、delete_edge_config_schema
• Edge Config 令牌：create_edge_config_token、get_edge_config_token、list_edge_config_tokens、delete_edge_config_tokens
• Edge Config 备份：list_edge_config_backups、get_edge_config_backup

访问控制与安全

• 访问组：create_access_group、delete_access_group、update_access_group、get_access_group、list_access_groups
• 访问组项目：create_access_group_project、delete_access_group_project、get_access_group_project、list_access_group_projects
• 访问组成员：list_access_group_members
• 身份验证：create_auth_token、delete_auth_token、get_auth_token、list_auth_tokens、sso_token_exchange
• 防火墙：create_firewall_bypass、delete_firewall_bypass、get_firewall_bypass、get_attack_status、update_attack_mode、get_firewall_config、update_firewall_config、put_firewall_config

监控与日志

• 日志传输：logdrain_create、logdrain_createIntegration、logdrain_delete、logdrain_deleteIntegration、logdrain_get、logdrain_list、logdrain_listIntegration
• Webhook：create_webhook、delete_webhook、list_webhooks、get_webhook
• 分析：send_web_vitals

用户管理

• 用户：delete_user、get_user、list_user_events

市场与集成

• 市场：create_marketplace_event、get_marketplace_account、get_marketplace_invoice、get_marketplace_member、import_marketplace_resource、submit_marketplace_billing、submit_marketplace_invoice、update_marketplace_secrets、marketplace_sso_token_exchange、submit_marketplace_balance、marketplace_invoice_action
• 集成：int_delete、int_list、int_gitns、int_searchRepo、int_get、int_updateAction

环境与密钥

• 环境：create_environment、delete_environment、get_environment、list_environments、update_environment
• 密钥：create_secret、update_secret_name、delete_secret、get_secret、list_secrets

构件与别名

• 构件：check_artifact、download_artifact、get_artifact_status、query_artifacts、record_artifact_events、upload_artifact
• 别名：assign_alias、delete_alias、get_alias、list_aliases、list_deployment_aliases

💡 用法

配置完成后，MCP 服务会通过 Cursor 的 Composer 提供所有 Vercel 管理工具。只需描述你想对 Vercel 项目执行的操作，AI 就会使用相应的命令。

示例：

• 📋“列出我的所有项目”
• 🚀“创建一个新的 Next.js 项目”
• 🌐“为我的项目添加自定义域名”
• 🔑“设置环境变量”

🔒 安全注意事项

• 🔐 妥善保管 Vercel 访问令牌
• ⚠️ 切勿将敏感凭据提交到版本控制系统
• 👮 使用适当的访问控制和权限
• 🛡️ 遵循 Vercel 的安全最佳实践

🛠️ 故障排除

常见问题

1. Node.js 路径问题

   • 确保使用正确的 Node.js 路径
   • 在 Mac/Linux 上：使用 which node 查找正确的路径
   • 在 Windows 上：使用 where node 查找正确的路径

2. 访问令牌问题

   • 确认 Vercel 访问令牌有效
   • 检查令牌是否具有所需权限
   • 确保令牌尚未过期

3. MCP 未检测到工具

   • 点击 Cursor 的 MCP 设置中的刷新按钮
   • 确保服务正在运行（没有错误消息）
   • 确认 Vercel 凭据有效

调试模式

在命令前添加 DEBUG=true，即可查看详细日志：

# 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"

如果问题仍然存在，请提交问题并附上：

• 您的操作系统
• Node.js 版本（node --version）
• 完整错误消息
• 复现步骤

🤝 参与贡献

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

📄 许可证

---