Angular PR Review MCP

여러 Angular 저장소에서 자동화된 풀 리퀘스트 리뷰 워크플로를 위한 재사용 가능한 MCP 서버입니다.

이 패키지는 세 가지 MCP 도구를 제공합니다:

• get_pr_review_template

• generate_pr_diff

• read_pr_diff

• save_pr_review

대상 저장소 컨텍스트(현재 작업 디렉터리)에서 실행되므로, 게시된 하나의 패키지를 모든 Angular 앱에서 재사용할 수 있습니다.

요구사항

• Node.js 20+

• Git이 설치되어 있고 PATH에 포함되어 있어야 합니다.

• Copilot Chat MCP를 지원하는 VS Code

Related MCP server: GitHub PR Review Server

로컬 개발

npm install
npm run build
npm run dev

npm에 게시

공개적으로 게시하는 경우:

npm login
npm publish --access public

스코프 패키지로 게시하는 경우(계정/조직 소유권에 권장):

1. package.json의 name 필드를 스코프로 변경합니다(예: @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 저장소에서 사용

각 Angular 저장소에 .vscode/mcp.json을 추가하거나 업데이트합니다:

{
  "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"
      }
    }
  }
}

스코프 패키지의 경우 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. 커밋 SHA로 generate_pr_diff를 실행합니다.

2. read_pr_diff로 diff 콘텐츠를 가져옵니다.

3. save_pr_review로 마크다운 리뷰 코멘트를 저장합니다.

권장 흐름:

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 도구는 동일한 정책 텍스트(선택적 커밋 토큰 교체 포함)를 반환하므로 리뷰를 결정적으로 유지하고 토큰 소모를 줄여줍니다.