giancarloerra/SocratiCode

해결하는 문제

SocratiCode는 대규모 리포지토리에 대한 깊은 의미적 이해를 AI 어시스턴트에게 제공하는 코드베이스 컨텍스트 엔진입니다. 단순한 텍스트 검색(Grep)으로는 충분하지 않은 수백만 줄에 이르는 복잡한 코드베이스를 탐색하는 데 어려움을 겪는 AI 에이전트의 문제를 해결합니다. 아키텍처 패턴, 종속성, 심볼 수준의 영향을 이해하기 위해서는 더 정교한 분석이 필요합니다.

작동 방식

이 시스템은 AI 호스트와 통합하기 위해 Model Context Protocol (MCP) 서버를 사용합니다. AST 인식 코드 청크 분할과 하이브리드 검색 접근 방식을 활용합니다. 밀도 벡터 임베딩(의미 검색)과 BM25 스파스 벡터(키워드 검색)를 Qdrant 벡터 데이터베이스를 사용해 상호 역순 순위 융합(RRF)으로 결합합니다. 또한 18개 언어를 지원하는 다국어 종속성 그래프를 구축하여 심볼 수준의 영향 범위 분석과 호출 흐름 추적을 가능하게 합니다.

대상 사용자

Claude Code, Cursor, VS Code Copilot, Gemini CLI와 같은 AI 코딩 어시스턴트를 사용하며, 다양한 AI 도구 간에 지속 가능한 컨텍스트 레이어를 필요로 하는 기업 수준의 대규모 리포지토리(최대 4,000만 줄 코드 테스트 완료)에서 작업하는 개발자들을 위한 것입니다.

주요 특징

• 하이브리드 검색: 의미 검색과 키워드 검색을 결합하여 고정밀 코드 검색을 제공합니다.
• 심층 지능: 18개 언어에 걸쳐 심볼 수준의 영향 범위와 호출 흐름 추적을 지원합니다.
• 제로 구성: Qdrant와 Ollama의 Docker 기반 자동 배포로 로컬 우선의 프라이버시 보장.
• 도구 독립성: 하나의 인덱스를 여러 AI 에이전트와 IDE에서 공유 가능.
• 재시도 가능한 인덱싱: 체크포인트를 포함한 배치 인덱싱으로 대규모 코드베이스에서의 크래시나 중단에 대응.
• 시각적 탐색: 코드 종속성을 탐색할 수 있는 인터랙티브 HTML 그래프 탐색기 포함.