MIT 라이선스를 적용한 로컬 전용 코드 지식 그래프 도구를 만들었습니다 (클라우드 없음)
I built a code knowledge graph tool that's actually MIT licensed (fully local, no cloud)
핵심 요약
로컬에서 작동하며 클라우드 의존성이 없는 MIT 라이선스 기반 코드 지식 그래프 도구 'repopedia' 소개.
- 코드 지식 그래프 — 로컬 SQLite 기반으로 코드 호출 관계를 분석함.
- AI 에이전트 최적화 — MCP 서버를 통해 Claude Code 등에서 즉시 쿼리 가능함.
- 완전 로컬 환경 — 클라우드 업로드나 도커 없이 pip 설치만으로 사용 가능함.
- 증분 업데이트 — git-diff를 활용해 변경된 파일만 효율적으로 재파싱함.
이게 좀 마이너한 문제일 수도 있는데, 회사에서 엄청나게 큰 파이썬 코드베이스를 다루다 보니 공통 함수 하나만 건드려도 거의 러시안 룰렛 하는 기분임. grep은 누가 그 함수를 호출하는지가 아니라 그냥 코드 어디에 언급됐는지만 알려주거든. 더 큰 문제는 내가 주력으로 쓰는 코딩 에이전트인 Claude Code도 grep 위주로 돌아가서 결과가 영 시원찮다는 거임.
내가 원하던 툴이 이미 있긴 했는데(GitNexus), 그건 PolyForm 라이선스라 회사에서 쓰기엔 절대 안 됨. 솔직히 라이선스 문제를 떠나서, 시중에 나와 있는 코드 그래프 툴 절반은 레포지토리를 자기네 클라우드에 올리라거나 도커 스택이랑 벡터 데이터베이스를 돌리라고 하던데, 회사 환경에선 둘 다 불가능함. 그래서 주말 며칠 갈아 넣어서 직접 만들었음. MIT 라이선스고, 전부 로컬 머신에서 돌아감.
툴 이름은 repopedia임. pip install로 설치하고 레포지토리에서 돌리면 SQLite 파일 하나에 코드 그래프를 뚝딱 만들어줌(파싱은 tree-sitter 씀). 장점은 서버도 없고, 도커도 필요 없고, API 키도 안 씀. 어디로 데이터가 나가는 것도 아니고, 그냥 디스크에 .db 파일 하나 생기는 게 끝임. 이걸로 "이 함수 누가 호출함?"이라든가 "이거 수정하면 영향 범위가 어디까지임?" 같은 질문을 던지면, 간접 호출까지 싹 다 추적해서 알려줌. 코드베이스 위키를 덤프 떠주는 기능도 있는데, 솔직히 이건 내가 보려고 만든 거임.
내가 제일 잘 써먹는 건 MCP 서버 기능임. Claude Code 쓸 때 원래는 지가 알아서 grep 돌리면서 뻘짓하는데, 이제는 텍스트 검색 다섯 번씩 할 필요 없이 그래프에 바로 물어봐서 파일이랑 라인 번호까지 한 방에 정확한 답을 받아옴. 임베딩 모델 같은 거 안 쓰고 그냥... 그래프 그 자체임. 로컬 모델들은 검색 성능이 영 별로라 이 방식이 훨씬 중요할 듯.
저장소: https://github.com/bolongpa/repopedia
미리 말해두는데, 이제 0.2.1 버전임. 파이썬이랑 타입스크립트만 지원함. self를 통한 메서드 호출은 이름 매칭으로 해결하는데, 거대한 클래스 트리에서는 말 그대로 좀 불안정함. 혹시 자기 레포에서 돌려보고 멍청한 결과 나오면 꼭 좀 알려주셈. ¯\_(ツ)_/¯
