Vercel MCP 服务器 🚀

🔥 一个强大的模型上下文协议 (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"; // 请替换为您的实际令牌
     

     在 src/index.ts 中：

     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // 请替换为您的实际令牌
     

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

   对于 macOS：

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

   对于 Windows：

   # 默认安装
   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 安装
   C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
   

   对于 Linux：

   # 默认安装
   /usr/bin/node /path/to/vercel-mcp/dist/index.js
   
   # NVM 安装
   ~/.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
• 边缘配置: create_edge_config, update_edge_config, delete_edge_config, get_edge_config, list_edge_configs
• 边缘配置项: list_edge_config_items, get_edge_config_item, update_edge_config_items
• 边缘配置模式: get_edge_config_schema, update_edge_config_schema, delete_edge_config_schema
• 边缘配置令牌: create_edge_config_token, get_edge_config_token, list_edge_config_tokens, delete_edge_config_tokens
• 边缘配置备份: 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
• Webhooks: 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。

📄 许可证