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 请求。

📄 许可证