Angular PR Review MCP

Переиспользуемый MCP-сервер для автоматизированных рабочих процессов ревью pull request в нескольких Angular-репозиториях.

Этот пакет предоставляет три MCP-инструмента:

• get_pr_review_template

• generate_pr_diff

• read_pr_diff

• save_pr_review

Он работает в контексте целевого репозитория (текущей рабочей директории), поэтому один опубликованный пакет можно переиспользовать в любом Angular-приложении.

Требования

• Node.js 20+

• Установленный Git, доступный в PATH

• VS Code с поддержкой Copilot Chat MCP

Related MCP server: GitHub PR Review Server

Локальная разработка

npm install
npm run build
npm run dev

Публикация в npm

Если публикуете в открытый доступ:

npm login
npm publish --access public

Если публикуете под scoped-пакетом (рекомендуется для аккаунтов/организаций):

1. Измените поле name в package.json на ваш scope, например @your-scope/angular-pr-review-mcp.

2. Опубликуйте:

npm login
npm publish --access public

Создание отдельного GitHub-репозитория

Из этой папки создайте в вашем аккаунте отдельный репозиторий и запушьте в него:

git init
git branch -M main
git remote add origin https://github.com/<your-username>/angular-pr-review-mcp.git
git add .
git commit -m "Initial reusable Angular PR review MCP package"
git push -u origin main

Использование из любого Angular-репозитория

Добавьте или обновите .vscode/mcp.json в каждом Angular-репозитории:

{
  "servers": {
    "angular-pr-review": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "angular-pr-review-mcp"],
      "cwd": "${workspaceFolder}",
      "env": {
        "PR_REVIEW_BASE_BRANCH": "main",
        "PR_REVIEW_OUTPUT_DIR": "pr_review"
      }
    }
  }
}

Для scoped-пакета замените angular-pr-review-mcp на ваше опубликованное имя.

Переменные окружения

• PR_REVIEW_BASE_BRANCH: целевая базовая ветка для сравнения (по умолчанию main)

• PR_REVIEW_OUTPUT_DIR: каталог артефактов ревью (по умолчанию pr_review в корне репозитория)

• PR_REVIEW_REPO_ROOT: переопределение корня репозитория (по умолчанию текущая рабочая директория)

• PR_REVIEW_SERVER_NAME: имя MCP-сервера (по умолчанию angular-pr-review)

Рабочий процесс инструментов

1. generate_pr_diff с SHA коммита.

2. read_pr_diff для получения содержимого diff.

3. save_pr_review для сохранения markdown-комментариев ревью.

Рекомендуемый порядок:

1. Сначала get_pr_review_template, чтобы загрузить локальные критерии ревью и избежать повторного вывода правил при каждом запуске.

2. generate_pr_diff и read_pr_diff для сбора доказательств.

3. save_pr_review для итогового отчёта.

Сгенерированные файлы записываются в настроенную выходную папку в каждом репозитории, использующем пакет.

Локальный артефакт шаблона

Репозиторий включает pr_review_prompt_template.md, чтобы команды могли версионировать рекомендации по ревью в системе контроля версий. Инструмент get_pr_review_template возвращает тот же текст политики (с опциональной заменой токена коммита), что помогает делать ревью детерминированными и снижает расход токенов.