🚀 Deploy MCP

Despliega cualquier sitio web en Vercel — directamente desde tu IDE de IA, en segundos.

Gratis. Código abierto. Cero costes de servidor. Hecho para vibe coders.

Inicio rápido • Configuración del IDE • Herramientas • Solución de problemas • Contribuciones

✨ ¿Qué es Deploy MCP?

Deploy MCP es un servidor MCP (Model Context Protocol) gratuito y de código abierto que permite a tu asistente de codificación con IA (Cursor, VS Code, Antigravity, etc.) desplegar tu sitio web en Vercel automáticamente — con sincronización completa de variables de entorno, validación de compilación y comprobaciones de seguridad de git.

Solo di "Despliega esto" en tu chat de IA. Eso es todo.

You:  "Deploy this website."

AI:   ✓ Next.js detected
      ✓ Build check passed
      ✓ Environment variables verified (secrets never exposed)
      ✓ Deployed to Vercel

      🎉 Live at: https://my-portfolio.vercel.app

Related MCP server: Vercel MCP Relay Server

⚡ Inicio rápido — Despliega en 3 pasos

Paso 1 — Ejecuta la configuración (solo una vez)

Abre tu terminal y ejecuta:

npx @tusharjain-19/deploy-mcp setup

Esto hará:

• Te pedirá tu Token de Acceso Personal de Vercel (mira cómo obtenerlo abajo)

• Lo guardará de forma segura en tu máquina

• Imprimirá la configuración exacta para pegar en tu IDE

Cómo obtener tu Token de Vercel:

1. Ve a vercel.com/account/tokens

2. Haz clic en "Crear Token"

3. Ponle cualquier nombre (por ejemplo, deploy-mcp)

4. Establece el alcance a Acceso Completo

5. Copia el token y pégalo cuando el asistente de configuración lo pida

Paso 2 — Añádelo a tu IDE

Copia la configuración correcta para tu IDE y añádela a tu archivo de configuración:

Cursor

Ubicación del archivo: %APPDATA%\Cursor\User\settings\cursor_settings.json (Windows) o ~/.cursor/rules/cursor_settings.json (Mac/Linux)

{
  "mcpServers": {
    "deploy": {
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"],
      "disabled": false
    }
  }
}

VS Code + Extensión de Claude

Ubicación del archivo: settings.json (Ctrl+Shift+P → "Abrir JSON de configuración")

{
  "claude.mcp.servers": [
    {
      "name": "deploy",
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  ]
}

Antigravity (VS Code + Antigravity AI)

Ubicación del archivo: settings.json (Ctrl+Shift+P → "Abrir JSON de configuración")

{
  "claude.mcp.servers": [
    {
      "name": "deploy",
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  ]
}

✅ Reinicia tu IDE después de guardar la configuración.

Paso 3 — ¡Despliega!

Abre la carpeta de tu proyecto en tu IDE y dile a la IA:

"Deploy this website"

La IA se encarga de todo a partir de ahí:

1. Scans your project           → Detects Next.js / React / Vue / etc.
2. Runs build check             → Makes sure your code compiles
3. Checks git status            → Warns if files aren't committed
4. Scans environment variables  → Keys only, values NEVER exposed to AI
5. Syncs missing env vars       → Uploads secrets directly to Vercel
6. Deploys to Vercel            → Triggers the actual deployment
7. Polls until live             → Waits and confirms it's up
8. Returns your live URL 🎉

🔄 Control de versiones (Git) — Integrado

Deploy MCP tiene soporte completo de Git integrado. Tu IA puede:

Mejores prácticas: Siempre confirma tu código antes de desplegar. Pide a la IA: "Confirma mis cambios con el mensaje 'fix: update homepage' y luego despliega"

Las herramientas de git funcionan automáticamente durante el despliegue — si tienes cambios sin confirmar, la IA te avisará y te preguntará si quieres confirmar primero.

🧰 Herramientas disponibles

Tu IA tiene acceso a 16 herramientas en 4 módulos:

📦 Herramientas de proyecto

🔐 Herramientas de variables de entorno

Seguridad: Los valores secretos nunca llegan a la IA. Solo se muestran los nombres de las claves. Los valores van directamente de tu máquina a Vercel.

🌿 Herramientas de Git

☁️ Herramientas de Vercel

🛠 Solución de problemas

❌ "Vercel no autenticado" o error de token

npx @tusharjain-19/deploy-mcp setup

Vuelve a ejecutar la configuración y pega un token nuevo. Asegúrate de que el token tenga alcance de Acceso Completo.

❌ "MCP no aparece en mi IDE"

1. Vuelve a comprobar la configuración JSON que pegaste — busca comas o corchetes faltantes

2. Reinicia completamente tu IDE (cierra todas las ventanas, vuelve a abrirlo)

3. Prueba el servidor manualmente:

   npx @tusharjain-19/deploy-mcp

   Deberías ver: Deploy MCP server running on stdio

❌ "Compilación fallida" durante el despliegue

Pide a tu IA: "Diagnostica el fallo de compilación y arréglalo" — la herramienta diagnose_build_failure analizará automáticamente los registros de error y le dirá a la IA exactamente qué corregir.

Causas comunes:

• Falta npm install → ejecuta npm install en tu proyecto

• Versión incorrecta de Node.js → añade "engines": { "node": "20" } a package.json

• Falta una variable de entorno → pide a la IA que sincronice tus variables de entorno

❌ "Las variables de entorno no se sincronizan"

• Asegúrate de que tu token de Vercel tenga permisos de Acceso Completo

• Comprueba que el nombre del proyecto que le dices a la IA coincida exactamente con el nombre de tu proyecto en Vercel

• Ejecuta: "Compara mis variables de entorno locales con Vercel" — la IA mostrará exactamente lo que falta

❌ "Archivo .env accidentalmente en Git"

Pide a tu IA: "Comprueba si mi .env está rastreado por git"

La herramienta check_env_leak lo detectará. Si se encuentra, arréglalo:

# Remove .env from git tracking (keeps the file locally)
echo ".env" >> .gitignore
echo ".env.local" >> .gitignore
git rm --cached .env
git rm --cached .env.local
git commit -m "fix: remove .env from git tracking"

❌ Error "Módulo no encontrado" localmente

npm install
npm run build

❌ "No se puede encontrar la CLI de Vercel"

Deploy MCP usa la API REST de Vercel directamente — no se necesita la CLI de Vercel. Pero si quieres la CLI de todos modos:

npm install -g vercel

⚙️ Cómo funciona

 ┌─────────────────────────────────────────────────┐
 │  Your IDE (Cursor / VS Code / Antigravity)      │
 │                                                 │
 │  You say: "Deploy this"                         │
 └───────────────────┬─────────────────────────────┘
                     │ MCP Protocol (stdio)
                     ▼
 ┌─────────────────────────────────────────────────┐
 │  Deploy MCP Server (runs on YOUR machine)       │
 │                                                 │
 │  ├── detect_project()   → Read package.json     │
 │  ├── check_project()    → Run build locally     │
 │  ├── scan_env()         → Read .env names only  │
 │  ├── sync_env()         → Push secrets directly │
 │  └── deploy_to_vercel() → Trigger deployment    │
 └───────────────────┬─────────────────────────────┘
                     │ Vercel REST API
                     ▼
 ┌─────────────────────────────────────────────────┐
 │  Vercel                                         │
 │  ├── Finds or creates your project              │
 │  ├── Receives encrypted env vars                │
 │  ├── Builds your site                           │
 │  └── Returns your live URL 🎉                   │
 └─────────────────────────────────────────────────┘

Modelo de seguridad

❌  INSECURE (secret touches the AI):
    .env → AI Model → MCP → Vercel

✅  DEPLOY MCP (secret never leaves your machine):
    .env → MCP Process → Vercel API
               ↑
      AI sees key NAMES only, never values

🔧 Configuración de desarrollo

¿Quieres ejecutar Deploy MCP localmente desde el código fuente?

# 1. Clone the repo
git clone https://github.com/Tusharjain-19/deploy-mcp.git
cd deploy-mcp/mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Run setup wizard
npm run setup

# 5. Start the server (IDEs do this automatically)
npm run dev

Prueba todas las herramientas sin un IDE

npx @modelcontextprotocol/inspector npx tsx src/index.ts

Esto abre una interfaz de navegador donde puedes llamar a cada herramienta manualmente y ver las salidas.

Scripts disponibles

📁 Estructura del proyecto

mcp-server/
├── src/
│   ├── index.ts                    ← MCP server entry (all 16 tools registered)
│   │
│   ├── tools/
│   │   ├── smart-deploy.ts         ← All-in-one deploy with auto-diagnose
│   │   ├── check-project.ts        ← Build validation
│   │   ├── deploy.ts               ← Vercel deployment trigger
│   │   ├── diagnose.ts             ← Build failure diagnosis
│   │   ├── env-vars.ts             ← .env scanning, diffing, syncing
│   │   ├── git.ts                  ← Git status, commit, leak detection
│   │   ├── logs.ts                 ← Deployment log fetching
│   │   ├── delete-project.ts       ← Safe project deletion with OS prompt
│   │   └── project-report.ts       ← Master pre-flight report
│   │
│   ├── vercel/
│   │   └── client.ts               ← Vercel REST API wrapper
│   │
│   ├── utils/
│   │   ├── config.ts               ← Token storage/retrieval
│   │   ├── filesystem.ts           ← File reading utilities
│   │   └── framework-detector.ts   ← Framework & package manager detection
│   │
│   └── cli/
│       ├── index.ts                ← CLI entry point
│       └── setup.ts                ← Interactive setup wizard
│
├── dist/                           ← Compiled JS (auto-generated, git-ignored)
├── package.json
├── tsconfig.json
└── README.md

🗺 Hoja de ruta

🔄 Actualizaciones automáticas

Debido a que la configuración de tu IDE usa npx -y @tusharjain-19/deploy-mcp, Node.js obtendrá automáticamente la última versión de npm cada vez que tu IDE inicie el servidor. No se necesitan comandos de actualización manuales — siempre obtienes las últimas funciones y correcciones automáticamente.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Este es un proyecto gratuito y de código abierto construido para la comunidad.

# Fork the repo, then:
git clone https://github.com/YOUR-USERNAME/deploy-mcp.git
cd deploy-mcp/mcp-server
npm install

# Create a feature branch
git checkout -b feature/my-feature

# Make changes, then build and test
npm run build

# Commit and push
git commit -m "feat: add my feature"
git push origin feature/my-feature

# Open a Pull Request on GitHub

Por favor, abre un issue primero para cambios grandes. ¡Las correcciones de errores y las mejoras de documentación siempre son bienvenidas!

🔐 Seguridad

👨💻 Acerca de

Creado por Tushar Jain — herramientas que cierran la brecha entre la IA y el lanzamiento de productos reales.

• 🌐 tusharjain.in

• 🐙 @Tusharjain-19

📄 Licencia

Licencia MIT — 100% gratis para siempre. Úsala en proyectos comerciales, modifícala, distribúyela. Consulta LICENSE para el texto completo.

Hecho con ❤️ para vibe coders de todo el mundo

⭐ ¡Dale una estrella a este repo si te ahorró tiempo!