Vercel MCP服务器🚀
  ](https://nodejs.org/)  
🔥 一个强大的模型上下文协议（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⚙️ 配置
- 安装依赖项并构建项目：
npm install
npm run build- 设置您的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- 在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 - 边缘配置备份：
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 - 网页插件 ：
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项目做什么，人工智能就会使用适当的命令。
示例：
- 📋 “列出我的所有项目”
- 🚀 “创建一个新的Next.js项目”
- 🌐 “将自定义域添加到我的项目中”
- 🔑 “设置环境变量”
🔒 安全说明
- 🔐 确保您的Vercel访问令牌安全
- ⚠️ 切勿将敏感凭据提交到版本控制
- 👮 使用适当的访问控制和权限
- 🛡️ 遵循Vercel的安全最佳实践
🛠️ 故障排除
常见问题
- Node.js路径问题
- 确保你使用了正确的Node.js路径 - 在Mac/Linux上：使用 which node 找到正确的路径 - 在Windows上：使用 where node 找到正确的路径
- 访问令牌问题
- 验证您的Vercel访问令牌是否有效 - 检查令牌是否具有所需的权限 - 确保令牌未过期
- 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) - 完整错误消息
- 重现步骤
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📄 许可证
______________________________________________________________________
Built with ❤️ for the Cursor community
Cursor • Vercel • GitHub
