upgrade-pilot-mcp

English | Русский

MCP server that helps AI agents safely upgrade JavaScript / TypeScript projects — from dependency analysis to PR summary generation.

Supported packages

Languages & tooling: TypeScript, ESLint, Prettier, Babel, SWC Bundlers: Vite, Webpack, Rollup, esbuild, tsup, PostCSS, Sass Testing: Vitest, Jest, Mocha, Playwright, Cypress, Storybook, Supertest, MSW Frameworks: React, Next.js, Vue, Nuxt, Astro, SvelteKit, Remix, Angular, NestJS, Express, Fastify, Hono Data & state: Prisma, Drizzle ORM, TypeORM, Mongoose, Redux Toolkit, TanStack Query, Pinia, RxJS Networking: Axios, GraphQL, Socket.IO, Zod Infra & DX: Turbo, Nx, Husky, lint-staged, commitlint, Tailwind CSS, Lodash

Scoped families @nestjs/*, @storybook/*, @remix-run/*, @angular/* are recognized automatically.

Tools

Analysis & planning

| Tool | Purpose | | ---------------------------- | ------------------------------------------------------- | | analyze_project | Fingerprint the project: deps, configs, lockfile, stack | | detect_upgrade_paths | Compute safe upgrade steps per package | | find_breaking_changes | Surface version-aware migration guides and risk areas | | scan_repo_for_deprecations | Find deprecated patterns in the codebase | | generate_upgrade_plan | Build a phased upgrade plan | | run_upgrade_pipeline | All-in-one: analyze → paths → breaking → scan → plan |

Execution

| Tool | Purpose | | --------------------- | ----------------------------------------------------- | | apply_safe_codemods | Run deterministic codemods (dry-run by default) | | install_upgrade | Install specific package versions via npm/yarn/pnpm | | check_compatibility | Verify peerDependency compatibility before installing |

Validation & rollback

| Tool | Purpose | | -------------------- | -------------------------------------- | | validate_upgrade | Run type-check, lint, test, build | | create_checkpoint | Tag current HEAD for safe rollback | | restore_checkpoint | Hard-reset to a previous checkpoint | | list_checkpoints | List all upgrade-pilot checkpoint tags |

Reporting

| Tool | Purpose | | -------------------------- | --------------------------------------------- | | write_upgrade_pr_summary | Generate a reviewer-friendly markdown summary |

Token-saving features

• Compact output — 5 diagnostic tools accept outputFormat: "compact" (default) to strip verbose fields and return counts instead of arrays.
• Analysis caching — validate_upgrade, generate_upgrade_plan, and write_upgrade_pr_summary reuse a cached analysis when available, eliminating redundant project scans.
• Quiet validation — validate_upgrade accepts quietOnSuccess: true (default) to return a one-line summary when all checks pass.
• Pipeline tool — run_upgrade_pipeline replaces 5 sequential calls with one, storing full artifacts as resources while returning only a compact summary.

Resources

Each URI returns the latest artifact from the current session:

| URI | Content | | ----------------------------------- | -------------------------- | | upgrade://analysis/latest | Project analysis snapshot | | upgrade://paths/latest | Upgrade path results | | upgrade://breaking-changes/latest | Breaking change references | | upgrade://findings/latest | Deprecation findings | | upgrade://plan/latest | Upgrade plan | | upgrade://pipeline/latest | Full pipeline result | | upgrade://codemods/latest | Codemod results | | upgrade://validation/latest | Validation results | | upgrade://summary/latest | PR summary (markdown) |

Prompts

• plan_upgrade_route — walk the agent through a safe upgrade workflow
• draft_upgrade_pr — turn artifacts into a PR description

Codemods

| ID | Purpose | | ---------------------- | ----------------------------------------------------------- | | prisma-relation-mode | Add relationMode = "prisma" to Prisma schema | | eslint-flat-config | Generate eslint.config.mjs FlatCompat bridge from legacy | | tailwind-v4-import | Replace @tailwind directives with @import "tailwindcss" |

Setup

npm install
npm run build

MCP client configuration

Recommended after publishing:

Use this when the package is consumed from npm. If you are inside this repository itself, prefer the local development config below.

{
  "mcpServers": {
    "upgrade-pilot": {
      "command": "npx",
      "args": ["-y", "upgrade-pilot-mcp@latest"]
    }
  }
}

Local development:

{
  "mcpServers": {
    "upgrade-pilot": {
      "command": "node",
      "args": ["path/to/upgrade-pilot-mcp/dist/server.js"]
    }
  }
}

Windows note: if a client does not resolve npx, use npx.cmd as the command.

Security

• stdio transport only — no HTTP listener
• All operations are read-only by default
• Codemods require explicit mode: "apply"
• install_upgrade runs the detected package manager (npm/yarn/pnpm install)
• restore_checkpoint performs git reset --hard — destructive by design
• Validation runs only local scripts from the target repo
• No remote code execution

upgrade-pilot-mcp (RU)

English | Русский

MCP-сервер, помогающий AI-агентам безопасно обновлять JavaScript / TypeScript проекты — от анализа зависимостей до генерации описания PR.

Поддерживаемые пакеты

Языки и тулинг: TypeScript, ESLint, Prettier, Babel, SWC Сборщики: Vite, Webpack, Rollup, esbuild, tsup, PostCSS, Sass Тестирование: Vitest, Jest, Mocha, Playwright, Cypress, Storybook, Supertest, MSW Фреймворки: React, Next.js, Vue, Nuxt, Astro, SvelteKit, Remix, Angular, NestJS, Express, Fastify, Hono Данные и стейт: Prisma, Drizzle ORM, TypeORM, Mongoose, Redux Toolkit, TanStack Query, Pinia, RxJS Сеть: Axios, GraphQL, Socket.IO, Zod Инфра и DX: Turbo, Nx, Husky, lint-staged, commitlint, Tailwind CSS, Lodash

Scoped-семейства @nestjs/*, @storybook/*, @remix-run/*, @angular/* распознаются автоматически.

Инструменты

Анализ и планирование

| Инструмент | Назначение | | ---------------------------- | ------------------------------------------------------- | | analyze_project | Отпечаток проекта: зависимости, конфиги, lockfile, стек | | detect_upgrade_paths | Безопасные шаги обновления по каждому пакету | | find_breaking_changes | Версионные migration guides и зоны риска | | scan_repo_for_deprecations | Поиск устаревших паттернов в коде | | generate_upgrade_plan | Пофазный план обновления | | run_upgrade_pipeline | Всё-в-одном: анализ → пути → breaking → скан → план |

Выполнение

| Инструмент | Назначение | | --------------------- | ------------------------------------------------- | | apply_safe_codemods | Детерминистические кодмоды (dry-run по умолчанию) | | install_upgrade | Установка конкретных версий через npm/yarn/pnpm | | check_compatibility | Проверка совместимости peerDependencies |

Валидация и откат

| Инструмент | Назначение | | -------------------- | ---------------------------------------- | | validate_upgrade | Запуск type-check, lint, тестов и build | | create_checkpoint | Тег текущего HEAD для безопасного отката | | restore_checkpoint | Hard-reset к предыдущему чекпоинту | | list_checkpoints | Список всех чекпоинт-тегов upgrade-pilot |

Отчётность

| Инструмент | Назначение | | -------------------------- | ------------------------ | | write_upgrade_pr_summary | Markdown-описание для PR |

Экономия токенов

• Компактный вывод — 5 диагностических инструментов принимают outputFormat: "compact" (по умолчанию), убирая многословные поля и заменяя массивы на счётчики.
• Кеширование анализа — validate_upgrade, generate_upgrade_plan и write_upgrade_pr_summary используют кешированный анализ, если он есть, устраняя повторные сканирования.
• Тихая валидация — validate_upgrade принимает quietOnSuccess: true (по умолчанию) и возвращает однострочный итог, если все проверки пройдены.
• Pipeline — run_upgrade_pipeline заменяет 5 последовательных вызовов одним, сохраняя полные артефакты в ресурсах и возвращая только компактный итог.

Ресурсы

Каждый URI возвращает последний артефакт текущей сессии:

| URI | Содержимое | | ----------------------------------- | ----------------------------- | | upgrade://analysis/latest | Снимок анализа проекта | | upgrade://paths/latest | Пути обновления | | upgrade://breaking-changes/latest | Breaking changes | | upgrade://findings/latest | Найденные устаревшие паттерны | | upgrade://plan/latest | План обновления | | upgrade://pipeline/latest | Полный результат pipeline | | upgrade://codemods/latest | Результаты кодмодов | | upgrade://validation/latest | Результаты валидации | | upgrade://summary/latest | Саммари для PR (markdown) |

Промпты

• plan_upgrade_route — проводит агента через безопасный процесс обновления
• draft_upgrade_pr — превращает артефакты в описание PR

Кодмоды

| ID | Назначение | | ---------------------- | ----------------------------------------------------------------- | | prisma-relation-mode | Добавляет relationMode = "prisma" в схему Prisma | | eslint-flat-config | Генерирует eslint.config.mjs FlatCompat-мост из legacy-конфигов | | tailwind-v4-import | Заменяет директивы @tailwind на @import "tailwindcss" |

Установка

npm install
npm run build

Конфигурация MCP-клиента

Рекомендуемый вариант после публикации:

Используй этот вариант, когда пакет ставится из npm. Если ты находишься внутри самого репозитория, лучше использовать локальную конфигурацию ниже.

{
  "mcpServers": {
    "upgrade-pilot": {
      "command": "npx",
      "args": ["-y", "upgrade-pilot-mcp@latest"]
    }
  }
}

Для локальной разработки:

{
  "mcpServers": {
    "upgrade-pilot": {
      "command": "node",
      "args": ["path/to/upgrade-pilot-mcp/dist/server.js"]
    }
  }
}

Примечание для Windows: если клиент не находит npx, укажи в command значение npx.cmd.

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

• Только stdio transport — без HTTP
• Все операции read-only по умолчанию
• Кодмоды требуют явный mode: "apply"
• install_upgrade запускает обнаруженный пакетный менеджер (npm/yarn/pnpm install)
• restore_checkpoint выполняет git reset --hard — деструктивная операция
• Валидация запускает только локальные скрипты целевого репозитория
• Никакого удалённого выполнения кода