{
  "markdown": "# Vercel MCP\n\n<p align=\"right\">\n    <b>English</b> | <a href=\"./README_zh.md\">简体中文</a>\n</p>\n\n[![GitHub last commit](https://img.shields.io/github/last-commit/ZhanZiyuan/vercel-mcp)](https://github.com/ZhanZiyuan/vercel-mcp/commits/main/)\n[![GitHub License](https://img.shields.io/github/license/ZhanZiyuan/vercel-mcp)](https://github.com/ZhanZiyuan/vercel-mcp/blob/main/LICENSE)\n[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/ZhanZiyuan/vercel-mcp/total)](https://github.com/ZhanZiyuan/vercel-mcp/releases)\n\nBring the power of Vercel directly into your terminal with this Gemini CLI extension.\nIt utilizes the Model Context Protocol (MCP) to allow Gemini to manage deployments,\ncheck build logs, and analyze project status natively.\n\n## Features\n\n- **Full Vercel Integration**: Access 11+ tools and 12+ prompts provided by the official Vercel MCP server.\n- **Bilingual Support**: Optimized `GEMINI.md` context for seamless interaction in both English and Chinese.\n- **Custom Commands**: Shortcuts for common tasks (e.g., `/vercel:status`, `/vercel:debug`).\n\n## Prerequisites\n\n- [Gemini CLI](https://geminicli.com) installed.\n- Node.js and `npx` installed on your system.\n- A Vercel account.\n\n## Installation\n\n- **Clone or Create Directory**:\n\nEnsure your project structure looks like this:\n\n```text\nvercel-mcp/\n├── commands/\n│   └── vercel/\n├── GEMINI.md\n└── gemini-extension.json\n```\n\n- **Link the Extension**:\n\n  - Navigate to the project root and link it to Gemini CLI:\n\n    ```bash\n    gemini extensions link .\n    ```\n\n  - Or install the extension using the following command:\n\n    ```bash\n    gemini extensions install https://github.com/ZhanZiyuan/vercel-mcp\n    ```\n\n- **Restart Gemini CLI**:\n\nClose and reopen your terminal or restart the CLI session.\n\n- **Authenticate**:\n\nUpon first usage (e.g., running `/vercel:status`), Vercel will prompt you to authenticate via your browser.\n\n## Configuration\n\nThe extension is configured via `gemini-extension.json`.\nIt uses `npx` to run the remote MCP server directly, so no local build is required.\n\n```json\n{\n  \"name\": \"vercel-mcp\",\n  \"version\": \"1.0.0\",\n  \"description\": \"A Gemini CLI extension for Vercel's official MCP server.\",\n  \"contextFileName\": \"GEMINI.md\",\n  \"mcpServers\": {\n    \"vercel\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://mcp.vercel.com\"\n      ]\n    }\n  }\n}\n```\n\n## Usage\n\n### Custom Commands\n\nWe have mapped powerful MCP prompts to easy-to-use CLI commands:\n\n| Command          | Description                              | Underlying Prompt         |\n| ---------------- | ---------------------------------------- | ------------------------- |\n| `/vercel:status` | Get a summary of your latest deployment  | `quick_status`            |\n| `/vercel:debug`  | Analyze logs for the recent failed build | `debug_deployment_issues` |\n| `/vercel:help`   | Search Vercel documentation              | `vercel_help`             |\n\n### Natural Language\n\nYou can also ask Gemini naturally:\n\n- *\"List my recent projects.\"* (Uses `list_projects`)\n- *\"Why did my last deployment fail?\"* (Uses `get_deployment_build_logs`)\n- *\"Check if the domain my-app.com is available.\"* (Uses `check_domain_availability_and_price`)\n\n## Available Tools & Prompts\n\nThis extension exposes the following capabilities from Vercel:\n\n- **Tools**: `deploy_to_vercel`, `get_deployment`, `get_deployment_build_logs`, `list_projects`, `search_vercel_documentation`, and more.\n- **Prompts**: `analyze_deployment_performance`, `fix_recent_build`, `project_health_check`, etc.\n\n---\n\n*Based on the [Gemini CLI Extensions Guide](https://geminicli.com/docs/extensions/getting-started-extensions/) and [Vercel MCP Documentation](https://vercel.com/docs/mcp/vercel-mcp).*\n",
  "bytes": 3789,
  "sha": "8f51d4a6a531edde6a00332e7059af33b3c217f3fe3b9ea199e57b2d2332226b",
  "repo_slug": "zhanziyuan/vercel-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_zhanziyuan_vercel_mcp_ad52a7f8/readme"
}