🚀 Deploy MCP

Разверните любой сайт на Vercel — прямо из вашей AI IDE, за считанные секунды.

Бесплатно. С открытым исходным кодом. Ноль затрат на сервер. Создано для виб-кодеров.

Быстрый старт • Настройка IDE • Инструменты • Устранение неполадок • Вклад в проект

✨ Что такое Deploy MCP?

Deploy MCP — это бесплатный MCP-сервер (Model Context Protocol) с открытым исходным кодом, который позволяет вашему AI-ассистенту (Cursor, VS Code, Antigravity и т.д.) автоматически разворачивать ваш сайт на Vercel — с полной синхронизацией переменных окружения, проверкой сборки и проверками безопасности Git.

Просто скажите «Задеплой это» в чате с AI. Вот и всё.

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

⚡ Быстрый старт — развертывание за 3 шага

Шаг 1 — Запустите настройку (один раз)

Откройте терминал и выполните:

npx @tusharjain-19/deploy-mcp setup

Это:

• Запросит ваш персональный токен доступа Vercel (см. как его получить ниже)

• Сохранит его безопасно на вашем компьютере

• Выведет точную конфигурацию для вставки в вашу IDE

Как получить токен Vercel:

1. Перейдите на vercel.com/account/tokens

2. Нажмите «Создать токен»

3. Назовите его как угодно (например, deploy-mcp)

4. Установите область действия Полный доступ

5. Скопируйте токен и вставьте его, когда мастер настройки попросит

Шаг 2 — Добавьте в вашу IDE

Скопируйте подходящую конфигурацию для вашей IDE и добавьте её в файл настроек:

Cursor

Расположение файла: %APPDATA%\Cursor\User\settings\cursor_settings.json (Windows) или ~/.cursor/rules/cursor_settings.json (Mac/Linux)

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

VS Code + Claude Extension

Расположение файла: settings.json (Ctrl+Shift+P → «Открыть JSON настроек»)

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

Antigravity (VS Code + Antigravity AI)

Расположение файла: settings.json (Ctrl+Shift+P → «Открыть JSON настроек»)

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

✅ Перезапустите вашу IDE после сохранения конфигурации.

Шаг 3 — Деплой!

Откройте папку проекта в вашей IDE и скажите AI:

"Deploy this website"

AI сделает всё остальное:

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 🎉

🔄 Контроль версий (Git) — встроен

Deploy MCP имеет полную поддержку Git из коробки. Ваш AI может:

Лучшая практика: Всегда коммитьте код перед деплоем. Спросите AI: «Закоммить мои изменения с сообщением "fix: update homepage" и затем задеплой»

Инструменты Git работают автоматически во время деплоя — если у вас есть незакоммиченные изменения, AI предупредит вас и спросит, хотите ли вы сначала закоммитить.

🧰 Доступные инструменты

Ваш AI имеет доступ к 16 инструментам в 4 модулях:

📦 Инструменты проекта

🔐 Инструменты переменных окружения

Безопасность: Секретные значения никогда не попадают к AI. Показываются только имена ключей. Значения идут напрямую с вашего компьютера на Vercel.

🌿 Инструменты Git

☁️ Инструменты Vercel

🛠 Устранение неполадок

❌ «Vercel не аутентифицирован» или ошибка токена

npx @tusharjain-19/deploy-mcp setup

Повторно запустите настройку и вставьте новый токен. Убедитесь, что токен имеет область действия Полный доступ.

❌ «MCP не отображается в моей IDE»

1. Перепроверьте вставленную JSON-конфигурацию — ищите пропущенные запятые или скобки

2. Полностью перезапустите вашу IDE (закройте все окна, откройте заново)

3. Проверьте сервер вручную:

   npx @tusharjain-19/deploy-mcp

   Вы должны увидеть: Deploy MCP server running on stdio

❌ «Сборка не удалась» во время развертывания

Спросите вашего AI: «Диагностируй сбой сборки и исправь его» — инструмент diagnose_build_failure автоматически разберёт логи ошибок и скажет AI, что именно исправить.

Распространённые причины:

• Отсутствует npm install → выполните npm install в вашем проекте

• Неправильная версия Node.js → добавьте "engines": { "node": "20" } в package.json

• Отсутствует переменная окружения → попросите AI синхронизировать ваши переменные env

❌ «Переменные окружения не синхронизируются»

• Убедитесь, что ваш токен Vercel имеет разрешения Полный доступ

• Проверьте, что имя проекта, которое вы говорите AI, точно совпадает с именем вашего проекта Vercel

• Выполните: «Сравни мои локальные переменные env с Vercel» — AI покажет, чего именно не хватает

❌ «Файл .env случайно попал в Git»

Спросите вашего AI: «Проверь, отслеживается ли мой .env в git»

Инструмент check_env_leak обнаружит это. Если найдено, исправьте:

# 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» ошибка локально

npm install
npm run build

❌ «Не удаётся найти Vercel CLI»

Deploy MCP использует напрямую Vercel REST API — Vercel CLI не нужен. Но если вы всё же хотите CLI:

npm install -g vercel

⚙️ Как это работает

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

Модель безопасности

❌  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

🔧 Настройка для разработки

Хотите запустить Deploy MCP локально из исходников?

# 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

Тестирование всех инструментов без IDE

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

Это откроет браузерный интерфейс, где вы можете вызывать каждый инструмент вручную и видеть результаты.

Доступные скрипты

📁 Структура проекта

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

🗺 Дорожная карта

🔄 Автоматические обновления

Поскольку конфигурация вашей IDE использует npx -y @tusharjain-19/deploy-mcp, Node.js будет автоматически загружать последнюю версию с npm каждый раз, когда ваша IDE запускает сервер. Никаких ручных команд обновления не нужно — вы всегда получаете последние функции и исправления автоматически.

🤝 Вклад в проект

Вклад приветствуется! Это бесплатный проект с открытым исходным кодом, созданный для сообщества.

# 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

Пожалуйста, сначала откройте issue для крупных изменений. Исправления ошибок и улучшения документации всегда приветствуются!

🔐 Безопасность

👨💻 Об авторе

Создано Tushar Jain — инструменты, которые сокращают разрыв между AI и выпуском реальных продуктов.

• 🌐 tusharjain.in

• 🐙 @Tusharjain-19

📄 Лицензия

Лицензия MIT — 100% бесплатно навсегда. Используйте в коммерческих проектах, модифицируйте, распространяйте. См. LICENSE для полного текста.

Сделано с ❤️ для виб-кодеров повсюду

⭐ Поставьте звезду этому репозиторию, если он сэкономил вам время!