Vercel MCP Server

Vercel MCP 服务器🚀

🔥 强大的模型上下文协议 (MCP) 服务器，可通过 Cursor 的 Composer 和 Codeium 的 Cascade 为您的 Vercel 部署提供全面的管理控制。此工具提供全面的部署、域、环境变量等功能，可实现无缝的项目管理。

📚 目录

• 先决条件
• 快速入门
• 集成
• 特征
• 用法
• 安全说明
• 故障排除
• 贡献
• 执照

🔧 先决条件

• Node.js >= 16.x
• npm >= 8.x
• 拥有以下权限的 Vercel 帐户：
  • 访问令牌
  • 团队 ID（可选）
  • 项目 ID（可选）
• Cursor IDE 或 Codeium 的 Cascade（针对付费用户）

🚀 快速入门

📥 安装

⚙️ 配置

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
• 边缘配置： 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
• Edge 配置备份： 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即可查看详细日志：

如果您仍然遇到问题，请打开以下问题：

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

🤝 贡献

欢迎贡献代码！欢迎提交 Pull 请求。

📄 许可证