Vercel MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides integration with Codeium's Cascade for managing Vercel projects.

  • Supports creating and managing Next.js projects through Vercel deployments.

  • Provides full administrative control over Vercel deployments, including project management, deployments, domains, environment variables, and more.

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-mcpC:\path\to\vercel-mcp替换为您的实际安装路径。要查找您的 Node.js 路径:
    # macOS/Linux which node # Windows where node

注意:请确保您的 Vercel 访问令牌安全,切勿将其提交到版本控制中。

🎯 功能

🎯 可用工具

团队管理

  • 团队: create_teamdelete_teamget_teamlist_teamsupdate_team
  • 团队成员: list_team_membersinvite_team_memberremove_team_memberupdate_team_member

项目管理

  • 项目: list_projectscreate_projectdelete_projectupdate_projectpause_project
  • 项目成员: add_project_memberlist_project_membersremove_project_member
  • 项目转移: request_project_transferaccept_project_transfer

部署管理

  • 部署: create_deploymentcancel_deploymentget_deploymentdelete_deploymentlist_deployment
  • 部署事件: get_deployment_eventsupdate_deployment_integration
  • 部署文件: list_deployment_filesupload_deployment_filesget_deployment_file
  • 促销: promote_deploymentget_promotion_aliases

域名和 DNS 管理

  • 域名: add_domainremove_domainget_domainlist_domainsget_project_domain
  • 域操作: domain_checkdomain_pricedomain_configdomain_registrydomain_getdomain_listdomain_buydomain_registerdomain_removedomain_update
  • DNS: create_dns_recorddelete_dns_recordlist_dns_recordsupdate_dns_record
  • 证书: get_certissue_certremove_certupload_cert

环境与配置

  • 环境变量: add_envupdate_envdelete_envget_envlist_env
  • 边缘配置: create_edge_configupdate_edge_configdelete_edge_configget_edge_configlist_edge_configs
  • 边缘配置项: list_edge_config_itemsget_edge_config_itemupdate_edge_config_items
  • 边缘配置模式: get_edge_config_schemaupdate_edge_config_schemadelete_edge_config_schema
  • 边缘配置令牌: create_edge_config_tokenget_edge_config_tokenlist_edge_config_tokensdelete_edge_config_tokens
  • Edge 配置备份: list_edge_config_backupsget_edge_config_backup

访问控制和安全

  • 访问组: create_access_groupdelete_access_groupupdate_access_groupget_access_grouplist_access_groups
  • 访问组项目: create_access_group_projectdelete_access_group_projectget_access_group_projectlist_access_group_projects
  • 访问组成员: list_access_group_members
  • 身份验证: create_auth_tokendelete_auth_tokenget_auth_tokenlist_auth_tokenssso_token_exchange
  • 防火墙: create_firewall_bypassdelete_firewall_bypassget_firewall_bypassget_attack_statusupdate_attack_modeget_firewall_configupdate_firewall_configput_firewall_config

监控和日志记录

  • 日志流失: logdrain_createlogdrain_createIntegrationlogdrain_deletelogdrain_deleteIntegrationlogdrain_getlogdrain_listlogdrain_listIntegration
  • Webhook: create_webhookdelete_webhooklist_webhooksget_webhook
  • 分析: send_web_vitals

用户管理

  • 用户: delete_userget_userlist_user_events

市场与整合

  • 市场: create_marketplace_eventget_marketplace_accountget_marketplace_invoiceget_marketplace_memberimport_marketplace_resourcesubmit_marketplace_billingsubmit_marketplace_invoiceupdate_marketplace_secretsmarketplace_sso_token_exchangesubmit_marketplace_balancemarketplace_invoice_action
  • 集成: int_deleteint_listint_gitnsint_searchRepoint_getint_updateAction

环境与秘密

  • 环境: create_environmentdelete_environmentget_environmentlist_environmentsupdate_environment
  • 秘密: create_secretupdate_secret_namedelete_secretget_secretlist_secrets

文物与别名

  • 工件: check_artifactdownload_artifactget_artifact_statusquery_artifactsrecord_artifact_eventsupload_artifact
  • 别名: assign_aliasdelete_aliasget_aliaslist_aliaseslist_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即可查看详细日志:

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

📄 许可证


You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

强大的模型上下文协议 (MCP) 服务器,可通过 Cursor 的 Composer 或 Codeium 的 Cascade 实现无缝的 Vercel 项目管理,包括部署、域、环境变量和团队配置。

  1. 📚 Table of Contents
    1. 🔧 Prerequisites
      1. 🚀 Quick Start
        1. 📥 Installation
        2. ⚙️ Configuration
      2. 🎯 Features
        1. 🎯 Available Tools
      3. 💡 Usage
        1. 🔒 Security Notes
          1. 🛠️ Troubleshooting
            1. Common Issues
            2. Debug Mode
          2. 🤝 Contributing
            1. 📄 License
              ID: a2zu61kut4