Claude Code에 실제 PR 컨텍스트를 제공하는 로컬 MCP 서버 구축 — 90초 대신 33초 만에 리뷰하기
요약
Claude Code를 활용한 PR 리뷰 시 발생하는 컨텍스트 부족 문제를 해결하기 위해 로컬 MCP 서버를 구축하는 방법을 소개합니다. git blame과 이슈 연결 정보를 제공하여 리뷰 속도와 정확도를 대폭 향상시킵니다.
핵심 포인트
- 기존 PR 리뷰 방식의 컨텍스트 부족 및 코드 잘림 문제 지적
- MCP(Model Context Protocol)를 통한 로컬 도구 확장 가능성 제시
- gh CLI와 git 기반의 Node.js MCP 서버 구축 사례 공유
- Blame 정보 및 연결된 이슈를 포함한 고도화된 리뷰 환경 구축
Claude Code PR 리뷰의 문제점
저는 거의 모든 작업에 Claude Code를 사용합니다. 하지만 PR (Pull Request) 리뷰는 계속해서 저를 좌절하게 만들었습니다.
도구(tooling)가 없을 때의 워크플로우는 다음과 같습니다:
- PR URL 찾기
- 로컬에서
gh pr diff실행 후 약 800줄의 코드 복사 - Claude Code에 붙여넣기 (종종 함수 중간에서 잘림)
- 리뷰 요청
- 일반적인 피드백 받기: "이 부분은 괜찮아 보입니다. 에러 핸들링(error handling) 추가를 고려해보세요"
무엇이 빠졌을까요? Blame 컨텍스트 (누가 이 라인을 작성했는지, 언제, 왜), 연결된 이슈 (이 PR이 수정하려 했던 버그가 무엇인지), 그리고 인용을 강제하는 구조화된 리뷰 형식이 부족합니다.
Claude는 기본적으로 이 중 어떤 것도 알지 못합니다. 여러분은 고고학적 맥락(archaeological context) 없이 코드 리뷰를 요청하고 있는 것입니다.
해결책: 로컬 MCP 서버
MCP (Model Context Protocol)를 사용하면 Claude Code에 여러분의 머신에서 로컬로 실행되는 도구들을 제공할 수 있습니다. 이 서버는 stdio를 통해 JSON-RPC로 통신하며, Claude는 내장 도구를 호출하는 것과 동일한 방식으로 여러분의 도구를 호출합니다.
저는 gh CLI와 로컬 git을 기반으로 하는 4개의 도구를 갖춘 Node.js MCP 서버를 구축했습니다:
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기