코드베이스가 커지면 특정 함수가 어디에서 호출되는지와 변경 영향 범위를 파악하기 어려워집니다. codebase-memory-mcp는 코드 구조를 인덱싱해 AI 에이전트가 관계를 탐색할 수 있도록 돕는 도구입니다. 그래프 결과는 탐색의 출발점이며 실제 코드와 테스트를 대신하지 않습니다.
준비와 설치 전 확인
공식 저장소에서 운영체제 지원, 설치 방법, MCP 클라이언트 설정과 현재 버전을 확인하세요. 영상은 설치 스크립트와 UI 옵션을 소개합니다. 원격 스크립트를 실행하기 전에 내용을 읽고 무엇을 설치하거나 설정을 수정하는지 살펴보는 것이 좋습니다.
프로젝트의 코드가 민감하다면 인덱스 저장 위치와 연결된 모델·도구가 어떤 데이터를 처리하는지도 확인하세요. 로컬 인덱싱과 외부 모델에 코드 일부를 전달하는 것은 다른 단계입니다.
1. 테스트용 프로젝트를 인덱싱합니다
설치와 MCP 연결을 마친 뒤 에이전트에 다음과 같이 요청할 수 있습니다.
이 프로젝트를 인덱싱하고 전체 구조를 요약해 주세요.
인덱싱에서 제외된 파일이나 확인하지 못한 범위도 알려 주세요.
저장소는 index_repository를 비롯한 도구와 인덱싱 상태 확인 방법을 설명합니다. 사용하는 클라이언트가 서버를 인식하지 못하면 설정 경로와 서버 재시작 여부를 확인하세요.
2. 관계와 영향 범위를 살펴봅니다
공식 문서는 코드 구조를 살피는 get_architecture, 경로를 추적하는 trace_path, 변경 영향을 살펴보는 기능 등을 안내합니다. 예를 들어 다음처럼 요청할 수 있습니다.
[함수 이름]을 호출하는 코드와 관련 파일을 찾아 주세요.
찾은 관계가 실제 코드에 있는지 근거 파일도 함께 보여 주세요.
분석 결과는 언어와 코드 형태에 따라 누락되거나 다르게 연결될 수 있습니다. 중요한 변경은 해당 파일과 테스트를 직접 열어 확인하세요.
3. 결과와 사용량을 비교합니다
그래프를 이용했을 때 필요한 파일을 더 빨리 찾았는지, 인덱싱과 유지에 드는 시간은 얼마인지 실제 작업으로 비교합니다. 영상에 나온 토큰 90% 절감이나 완전한 보안은 모든 프로젝트에 적용되는 보장으로 확인되지 않았습니다. UI를 쓰려면 현재 저장소의 실행 방법과 포트 설정을 확인하세요.
이 글은 영상과 저장소 안내를 정리한 것이며 현재 환경에서 도구를 재설치하거나 인덱싱한 결과는 아닙니다. 비슷한 방식의 Graphify 코드 관계 탐색도 참고할 수 있습니다.
다음 한 걸음
내 환경에서 막힌 부분은 실행 단계와 함께 질문해 주세요. 바꿔 만든 결과도 함께 나눌 수 있습니다.