[Agent] 코드 리뷰 및 분석 agent 만들기(1)

지금까지 공부했던 내용을 가지고, 코드 리뷰 및 분석을 해주는 agent를 만들어보려고 한다.

 

1. 목적

- 현재까지 공부한 LLM 및 agent에 대해 복습하고, mcp를 활용하면서 좀 더 깊이 이해하기

- 코드 읽기 및 리뷰, 분석 보조 agent

 

2. 예상기능

• 변경된 코드 리뷰
• 특정 파일 및 코드 설명
• 잠재 버그 후보 찾기
• 테스트 필요 지점 추천
• 프로젝트 및 코드 구조 요약
• git diff 기반 리뷰

3. 개발 환경

• LLM: qwen2.5-coder:1.5b
• 실행 방식: Ollama
• Agent 구현: Node.js / TypeScript
• Tool 연결 방식: MCP
• 대상 프로젝트: 지정한 로컬 코드 폴더

 

4. 고려사항

• 한 번에 큰 코드베이스 전체를 넣지 않는다
• 파일을 필요한 만큼만 읽는다
• git diff 중심으로 분석한다
• 긴 파일은 일부만 읽거나 청크로 나눈다
• tool 결과를 바탕으로만 말하게 한다
• JSON/tool call 실패 가능성을 대비한다

 

5. MCP Tool 설계

agent가 직접 파일 시스템이나 git을 마음대로 만지는 게 아니라, MCP server가 허용한 tool만 호출하게 만들어야 함.

 

list_files
- 프로젝트 파일 목록 조회

read_file
- 특정 파일 읽기

search_text
- 문자열/정규식 검색

git_status
- 변경된 파일 확인

git_diff
- 변경 내용 확인

detect_project
- package.json, pyproject.toml 등으로 프로젝트 타입 감지

read_project_scripts
- package.json scripts 확인

run_tests
- 제한된 테스트 명령 실행

run_lint
- 제한된 lint 명령 실행

 

6. Agent 동작 흐름

1. 사용자 요청 입력
2. LLM에게 system prompt + tool 목록 전달
3. LLM이 필요한 tool 선택
4. MCP client가 tool 호출
5. tool 결과를 다시 LLM에게 전달
6. LLM이 추가 tool 호출 여부 판단
7. 최종 답변 생성