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.

Related MCP server: npmplus-mcp

Tools

Analysis & planning

Execution

Validation & rollback

Reporting

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:

Prompts

• plan_upgrade_route — walk the agent through a safe upgrade workflow

• draft_upgrade_pr — turn artifacts into a PR description

Codemods

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/* распознаются автоматически.

Инструменты

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

Выполнение

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

Отчётность

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

• Компактный вывод — 5 диагностических инструментов принимают outputFormat: "compact" (по умолчанию), убирая многословные поля и заменяя массивы на счётчики.

• Кеширование анализа — validate_upgrade, generate_upgrade_plan и write_upgrade_pr_summary используют кешированный анализ, если он есть, устраняя повторные сканирования.

• Тихая валидация — validate_upgrade принимает quietOnSuccess: true (по умолчанию) и возвращает однострочный итог, если все проверки пройдены.

• Pipeline — run_upgrade_pipeline заменяет 5 последовательных вызовов одним, сохраняя полные артефакты в ресурсах и возвращая только компактный итог.

Ресурсы

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

Промпты

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

• draft_upgrade_pr — превращает артефакты в описание PR

Кодмоды

Установка

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 — деструктивная операция

• Валидация запускает только локальные скрипты целевого репозитория

• Никакого удалённого выполнения кода