AI导哈

Vercel部署管理服务器

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

  • by zxw94FE
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 zxw94fe/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（面向付费用户）

🚀 快速开始

📥 安装

# 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"; // 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
  • 边缘配置备份： 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的安全最佳实践

🛠️ 故障排除

常见问题

  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)
  • 完整错误消息
  • 重现步骤

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

Built with ❤️ for the Cursor community

Cursor • Vercel • GitHub

相关 MCP