🚀 Deploy MCP

Stellen Sie jede Website auf Vercel bereit – direkt aus Ihrer KI-IDE, in Sekunden.

Kostenlos. Open Source. Keine Serverkosten. Gebaut für Vibe-Coder.

Schnellstart • IDE-Einrichtung • Tools • Fehlerbehebung • Mitwirken

✨ Was ist Deploy MCP?

Deploy MCP ist ein kostenloser Open-Source-MCP-Server (Model Context Protocol), der Ihrem KI-Coding-Assistenten (Cursor, VS Code, Antigravity usw.) ermöglicht, Ihre Website automatisch auf Vercel bereitzustellen – mit vollständiger Synchronisierung von Umgebungsvariablen, Build-Validierung und Git-Sicherheitsprüfungen.

Sagen Sie einfach "Stell das bereit" in Ihrem KI-Chat. Das war's.

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

⚡ Schnellstart – In 3 Schritten bereitstellen

Schritt 1 – Setup ausführen (nur einmal)

Öffnen Sie Ihr Terminal und führen Sie Folgendes aus:

npx @tusharjain-19/deploy-mcp setup

Dabei wird Folgendes passieren:

• Sie werden nach Ihrem Vercel Personal Access Token gefragt (siehe unten, wie Sie ihn erhalten)

• Er wird sicher auf Ihrem Rechner gespeichert

• Die genaue Konfiguration zum Einfügen in Ihre IDE wird ausgegeben

So erhalten Sie Ihren Vercel-Token:

1. Gehen Sie zu vercel.com/account/tokens

2. Klicken Sie auf "Create Token"

3. Benennen Sie ihn beliebig (z. B. deploy-mcp)

4. Setzen Sie den Geltungsbereich auf Full Access

5. Kopieren Sie den Token und fügen Sie ihn ein, wenn der Setup-Assistent Sie dazu auffordert

Schritt 2 – Zur IDE hinzufügen

Kopieren Sie die richtige Konfiguration für Ihre IDE und fügen Sie sie in Ihre Einstellungsdatei ein:

Cursor

Dateispeicherort: %APPDATA%\Cursor\User\settings\cursor_settings.json (Windows) oder ~/.cursor/rules/cursor_settings.json (Mac/Linux)

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

VS Code + Claude-Erweiterung

Dateispeicherort: settings.json (Strg+Umschalt+P → "Open Settings JSON")

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

Antigravity (VS Code + Antigravity AI)

Dateispeicherort: settings.json (Strg+Umschalt+P → "Open Settings JSON")

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

✅ Starten Sie Ihre IDE nach dem Speichern der Konfiguration neu.

Schritt 3 – Bereitstellen!

Öffnen Sie Ihren Projektordner in Ihrer IDE und sagen Sie der KI:

"Deploy this website"

Die KI übernimmt von dort aus alles:

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 🎉

🔄 Versionskontrolle (Git) – Integriert

Deploy MCP verfügt über volle Git-Unterstützung direkt integriert. Ihre KI kann:

Best Practice: Committen Sie Ihren Code immer, bevor Sie bereitstellen. Fragen Sie die KI: "Committe meine Änderungen mit der Nachricht 'fix: update homepage' und stelle dann bereit"

Die Git-Tools arbeiten während der Bereitstellung automatisch – wenn Sie nicht committete Änderungen haben, warnt Sie die KI und fragt, ob Sie zuerst committen möchten.

🧰 Verfügbare Tools

Ihre KI hat Zugriff auf 16 Tools in 4 Modulen:

📦 Projekt-Tools

🔐 Tools für Umgebungsvariablen

Sicherheit: Geheime Werte erreichen die KI niemals. Nur Schlüsselnamen werden angezeigt. Werte gehen direkt von Ihrem Rechner zu Vercel.

🌿 Git-Tools

☁️ Vercel-Tools

🛠 Fehlerbehebung

❌ "Vercel not authenticated" oder Token-Fehler

npx @tusharjain-19/deploy-mcp setup

Führen Sie das Setup erneut aus und fügen Sie einen frischen Token ein. Stellen Sie sicher, dass der Token den Geltungsbereich Full Access hat.

❌ "MCP wird in meiner IDE nicht angezeigt"

1. Überprüfen Sie die eingefügte JSON-Konfiguration – achten Sie auf fehlende Kommas oder Klammern

2. Starten Sie Ihre IDE vollständig neu (alle Fenster schließen, neu öffnen)

3. Testen Sie den Server manuell:

   npx @tusharjain-19/deploy-mcp

   Sie sollten Folgendes sehen: Deploy MCP server running on stdio

❌ "Build failed" während der Bereitstellung

Fragen Sie Ihre KI: "Diagnostiziere den Build-Fehler und behebe ihn" – das Tool diagnose_build_failure analysiert automatisch die Fehler-Logs und sagt der KI genau, was zu beheben ist.

Häufige Ursachen:

• Fehlendes npm install → führen Sie npm install in Ihrem Projekt aus

• Falsche Node.js-Version → fügen Sie "engines": { "node": "20" } zu package.json hinzu

• Fehlende Umgebungsvariable → bitten Sie die KI, Ihre Env-Variablen zu synchronisieren

❌ "Umgebungsvariablen werden nicht synchronisiert"

• Stellen Sie sicher, dass Ihr Vercel-Token Full Access-Berechtigungen hat

• Prüfen Sie, dass der Projektname, den Sie der KI nennen, exakt mit Ihrem Vercel-Projektnamen übereinstimmt

• Führen Sie aus: "Vergleiche meine lokalen Env-Variablen mit Vercel" – die KI zeigt genau, was fehlt

❌ ".env-Datei versehentlich in Git"

Fragen Sie Ihre KI: "Prüfe, ob meine .env von Git verfolgt wird"

Das Tool check_env_leak erkennt es. Falls gefunden, beheben Sie es so:

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

❌ "Module not found"-Fehler lokal

npm install
npm run build

❌ "Vercel CLI nicht gefunden"

Deploy MCP verwendet direkt die Vercel-REST-API – keine Vercel-CLI erforderlich. Falls Sie die CLI trotzdem möchten:

npm install -g vercel

⚙️ So funktioniert es

 ┌─────────────────────────────────────────────────┐
 │  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 🎉                   │
 └─────────────────────────────────────────────────┘

Sicherheitsmodell

❌  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

🔧 Entwicklungseinrichtung

Möchten Sie Deploy MCP lokal aus dem Quellcode ausführen?

# 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

Alle Tools ohne IDE testen

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

Dadurch wird eine Browser-Oberfläche geöffnet, in der Sie jedes Tool manuell aufrufen und die Ausgaben sehen können.

Verfügbare Skripte

📁 Projektstruktur

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

🗺 Roadmap

🔄 Automatische Updates

Da Ihre IDE-Konfiguration npx -y @tusharjain-19/deploy-mcp verwendet, zieht Node.js automatisch die neueste Version von npm, jedes Mal wenn Ihre IDE den Server startet. Keine manuellen Update-Befehle nötig – Sie erhalten automatisch immer die neuesten Funktionen und Fehlerbehebungen.

🤝 Mitwirken

Beiträge sind willkommen! Dies ist ein kostenloses Open-Source-Projekt, das für die Community gebaut wurde.

# 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

Bitte eröffnen Sie für größere Änderungen zuerst ein Issue. Fehlerbehebungen und Dokumentationsverbesserungen sind jederzeit willkommen!

🔐 Sicherheit

👨💻 Über

Erstellt von Tushar Jain – Tools, die die Lücke zwischen KI und dem Ausliefern echter Produkte schließen.

• 🌐 tusharjain.in

• 🐙 @Tusharjain-19

📄 Lizenz

MIT-Lizenz – 100 % für immer kostenlos. Für kommerzielle Projekte nutzbar, modifizierbar, verteilbar. Vollständigen Text siehe LICENSE.

Mit ❤️ gebaut für Vibe-Coder überall

⭐ Starren Sie dieses Repo, wenn es Ihnen Zeit gespart hat!