VERRCEL-MCP服务器

Name: VERRCEL-MCP服务器
Author: Quegenx

作者：Quegenx58 星标更新：2025-02-24

安装使用来源：spider==github.com

项目介绍

Vercel MCP 服务器 🚀

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

📚 目录

先决条件
快速开始
集成
功能
使用方法
安全注意事项
故障排除
贡献
许可证

🔧 先决条件

Node.js >= 16.x
npm >= 8.x
一个Vercel账户，包含：
- 访问令牌
- 团队ID（可选）
- 项目ID（可选）
Cursor IDE或Codeium的Cascade（针对付费用户）

🚀 快速开始

📥 安装

# 克隆仓库
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server

# 安装依赖
npm install

# 构建项目
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"; // 替换为您的实际令牌
```
  在 src/index.ts 中：
```
export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // 替换为您的实际令牌
```

在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的安全最佳实践

🛠️ 故障排除

常见问题

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)
完整的错误信息
复现步骤

🤝 贡献

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

📄 许可证

<div align="center"> <p>为Cursor社区打造 ❤️</p> <p> <a href="https://cursor.sh">Cursor</a> • <a href="https://vercel.com">Vercel</a> • <a href="https://github.com/Quegenx">GitHub</a> </p> </div>