Angular PR Review MCP

Servidor MCP reutilizable para flujos de trabajo automatizados de revisión de pull requests en múltiples repositorios de Angular.

Este paquete expone tres herramientas MCP:

• get_pr_review_template

• generate_pr_diff

• read_pr_diff

• save_pr_review

Se ejecuta en el contexto del repositorio de destino (el directorio de trabajo actual), por lo que un mismo paquete publicado puede reutilizarse en cualquier aplicación Angular.

Requisitos

• Node.js 20+

• Git instalado y disponible en PATH

• VS Code con soporte para Copilot Chat MCP

Related MCP server: GitHub PR Review Server

Desarrollo local

npm install
npm run build
npm run dev

Publicar en npm

Si se publica públicamente:

npm login
npm publish --access public

Si se publica como paquete con ámbito (recomendado para propiedad de cuenta/organización):

1. Cambia el campo name en package.json a tu ámbito, por ejemplo @your-scope/angular-pr-review-mcp.

2. Publica:

npm login
npm publish --access public

Crear un repositorio de GitHub separado

Desde esta carpeta, crea y sube a un repositorio dedicado en tu cuenta:

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

Usar desde cualquier repositorio de Angular

Añade o actualiza .vscode/mcp.json en cada repositorio de 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"
      }
    }
  }
}

Para un paquete con ámbito, sustituye angular-pr-review-mcp por tu nombre publicado.

Variables de entorno

• PR_REVIEW_BASE_BRANCH: rama base de destino para la comparación (por defecto main)

• PR_REVIEW_OUTPUT_DIR: directorio de artefactos de revisión (por defecto pr_review en la raíz del repositorio)

• PR_REVIEW_REPO_ROOT: anula la raíz del repositorio (por defecto el directorio de trabajo actual)

• PR_REVIEW_SERVER_NAME: nombre del servidor MCP (por defecto angular-pr-review)

Flujo de trabajo de las herramientas

1. generate_pr_diff con el SHA del commit.

2. read_pr_diff para recuperar el contenido del diff.

3. save_pr_review para guardar los comentarios de revisión en Markdown.

Flujo recomendado:

1. get_pr_review_template primero, para cargar la rúbrica de revisión local y evitar volver a derivar las reglas en cada ejecución.

2. generate_pr_diff y read_pr_diff para la recopilación de evidencia.

3. save_pr_review para el informe final.

Los archivos generados se escriben en la carpeta de salida configurada en cada repositorio consumidor.

Artefacto de plantilla local

El repositorio incluye pr_review_prompt_template.md para que los equipos puedan versionar las guías de revisión en el control de código fuente. La herramienta get_pr_review_template devuelve el mismo texto de política (con sustitución opcional de token de commit), lo que ayuda a mantener las revisiones deterministas y reduce el consumo de tokens.