English | 简体中文

Bring the power of Vercel directly into your terminal with this Gemini CLI extension. It utilizes the Model Context Protocol (MCP) to allow Gemini to manage deployments, check build logs, and analyze project status natively.

• Full Vercel Integration: Access 11+ tools and 12+ prompts provided by the official Vercel MCP server.
• Bilingual Support: Optimized GEMINI.md context for seamless interaction in both English and Chinese.
• Custom Commands: Shortcuts for common tasks (e.g., /vercel:status, /vercel:debug).

• Gemini CLI installed.
• Node.js and npx installed on your system.
• A Vercel account.

• Clone or Create Directory:

Ensure your project structure looks like this:

vercel-mcp/
├── commands/
│   └── vercel/
├── GEMINI.md
└── gemini-extension.json

• Link the Extension:

  • Navigate to the project root and link it to Gemini CLI:

    gemini extensions link .

  • Or install the extension using the following command:

    gemini extensions install https://github.com/ZhanZiyuan/vercel-mcp

• Restart Gemini CLI:

Close and reopen your terminal or restart the CLI session.

• Authenticate:

Upon first usage (e.g., running /vercel:status), Vercel will prompt you to authenticate via your browser.

The extension is configured via gemini-extension.json. It uses npx to run the remote MCP server directly, so no local build is required.

{
  "name": "vercel-mcp",
  "version": "1.0.0",
  "description": "A Gemini CLI extension for Vercel's official MCP server.",
  "contextFileName": "GEMINI.md",
  "mcpServers": {
    "vercel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.vercel.com"
      ]
    }
  }
}

We have mapped powerful MCP prompts to easy-to-use CLI commands:

You can also ask Gemini naturally:

• "List my recent projects." (Uses list_projects)
• "Why did my last deployment fail?" (Uses get_deployment_build_logs)
• "Check if the domain my-app.com is available." (Uses check_domain_availability_and_price)

This extension exposes the following capabilities from Vercel:

• Tools: deploy_to_vercel, get_deployment, get_deployment_build_logs, list_projects, search_vercel_documentation, and more.
• Prompts: analyze_deployment_performance, fix_recent_build, project_health_check, etc.

Based on the Gemini CLI Extensions Guide and Vercel MCP Documentation.