Claude의 코드베이스 탐색 효율을 높이는 구조적 지식 그래프 구축

섹션별 상세

기존의 grep 방식은 코드베이스를 단순 텍스트로 읽어 컨텍스트를 압축해야 하므로 토큰 비용이 높고 구조적 이해가 부족하다. AST나 LSP가 구조적 이해에는 유리하지만 관리가 복잡한 단점이 있다.

로컬 MCP 서버를 구축하여 코드베이스를 구조적 지식 그래프로 변환하는 방식을 채택했다. 그래프 노드에 키워드와 엣지 호출 메타데이터를 풍부하게 포함하여 Claude가 효율적으로 접근하도록 설계했다.

실제 워크플로 테스트에서 90%의 확률로 관련 파일을 정확히 찾아낸다. 나머지 10%의 경우에만 그래프 내에서 방향성 있는 grep을 수행하여 전체적인 토큰 비용을 최소화한다.

grep중립

코드베이스 검색

MCP추천

에이전트 연결 프로토콜

Claude추천

AI 에이전트