MCP HubMCP Hub
Quegenx

vercel-mcp-server

by: Quegenx

vercel mcp server

26created 24/02/2025
Visit
vercel

📌Overview

Purpose: To provide a powerful Model Context Protocol (MCP) server that offers full administrative control over Vercel deployments through Cursor's Composer and Codeium's Cascade.

Overview: The Vercel MCP Server simplifies project management for Vercel applications by integrating comprehensive tools for deployment, domain management, and environment configuration. It enhances usability with AI-driven command handling through Cursor.

Key Features:

  • Team Management: Facilitates creation, updating, and deletion of teams and team members, ensuring smooth collaboration across projects.

  • Deployment Management: Offers robust tools for deployment actions including creating, canceling, and listing deployments as well as managing deployment files and events.

  • Domain & DNS Management: Provides operations to add, remove, and manage domains, including detailed DNS management and domain registration functionalities.

  • Environment & Configuration Control: Allows users to manage environment variables and configurations efficiently, offering necessary access controls for secure operations.

  • Monitoring & Logging Tools: Includes features for log tracking, webhooks, and performance analytics to enhance oversight of deployments and application health.

Vercel MCP Server 🚀

A powerful Model Context Protocol (MCP) server that provides full administrative control over your Vercel deployments through both Cursor's Composer and Codeium's Cascade. This tool enables seamless project management with comprehensive features for deployments, domains, environment variables, and more.

📚 Table of Contents

  • Prerequisites
  • Quick Start
  • Features
  • Usage
  • Security Notes
  • Troubleshooting
  • Contributing
  • License

🔧 Prerequisites

  • Node.js >= 16.x
  • npm >= 8.x
  • A Vercel account with:
    • Access Token
    • Team ID (optional)
    • Project ID (optional)
  • Cursor IDE or Codeium's Cascade (for paying users)

🚀 Quick Start

📥 Installation

# 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

⚙️ Configuration

  1. Install dependencies and build the project:

    npm install
npm run build

  2. Set up your Vercel access token:

    • Go to https://vercel.com/account/tokens to generate your access token

    • Update the token in both of these files:

      In src/config/constants.ts:

      export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token

      In src/index.ts:

      export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token

  3. In Cursor's MCP settings, add the server with this command:

    For 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

    For 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

    For 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

    Replace /path/to/vercel-mcp or C:\path\to\vercel-mcp with your actual installation path.

    To find your Node.js path:

    # macOS/Linux
which node

# Windows
where node

Note: Keep your Vercel access token secure and never commit it to version control.

🎯 Features

Team Management

  • Manage teams and team members: create, delete, update, list, invite, remove

Project Management

  • Manage projects and project members; transfer projects

Deployment Management

  • Create, cancel, get, delete, list deployments
  • Manage deployment events and files
  • Promote deployments and manage aliases

Domain & DNS Management

  • Add, remove, get, and list domains
  • Perform domain operations such as check, buy, register, update, and remove
  • Manage DNS records and SSL certificates

Environment & Configuration

  • Manage environment variables
  • Create and manage Edge Configs, including schema, tokens, and backups

Access Control & Security

  • Manage access groups, members, and projects
  • Authentication tokens and Single Sign-On (SSO)
  • Firewall configuration and attack mode status

Monitoring & Logging

  • Manage log drains and integrations
  • Create and manage webhooks
  • Send analytics data

User Management

  • Manage users and user events

Marketplace & Integration

  • Marketplace events, accounts, invoices, members, billing, secrets, and SSO
  • Manage integrations and repositories

Environments & Secrets

  • Create, update, get, list, and delete environments and secrets

Artifacts & Aliases

  • Manage artifacts and deployment aliases

💡 Usage

Once configured, the MCP server provides all Vercel management tools through Cursor's Composer. Simply describe what you want to do with your Vercel projects, and the AI will use the appropriate commands.

Examples:

  • "List all my projects"
  • "Create a new Next.js project"
  • "Add a custom domain to my project"
  • "Set up environment variables"

🔒 Security Notes

  • Keep your Vercel access token secure.
  • Never commit sensitive credentials to version control.
  • Use appropriate access controls and permissions.
  • Follow Vercel's security best practices.

🛠️ Troubleshooting

Common Issues

  1. Node.js Path Issues

    • Ensure you're using the correct Node.js path
    • On Mac/Linux, use which node
    • On Windows, use where node

  2. Access Token Issues

    • Verify your Vercel access token is valid and has required permissions
    • Ensure the token hasn't expired

  3. MCP Not Detecting Tools

    • Refresh Cursor's MCP settings
    • Ensure the server is running and no errors are present
    • Verify your Vercel credentials

Debug Mode

Add DEBUG=true before your command to see detailed logs:

# 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"

If issues persist, please open an issue including:

  • Operating system
  • Node.js version (node --version)
  • Full error message
  • Steps to reproduce

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

Built with ❤️ for the Cursor community
Cursor • Vercel • GitHub