“Your AI reads code. SocratiCode understands it.” — 엔터프라이즈급 로컬 우선 코드베이스 인텔리전스 엔진. AI 어시스턴트가 대규모 코드베이스를 즉시 이해하도록 지원.
개요
SocratiCode는 AI 어시스턴트를 위한 오픈소스 코드베이스 컨텍스트 엔진입니다. 하이브리드 시맨틱/키워드 검색, 다국어 의존성 그래프, 심볼 레벨 영향도 분석 등을 제공합니다.
주요 성능 지표 (VS Code 2.45M 라인 기준)
- 컨텍스트 사용량 61% 감소
- 툴 호출 84% 감소
- 탐색 속도 37배 향상
- 지원 규모: ~4,000만 라인까지 벤치마크 완료
핵심 기능
검색 및 검색
- 하이브리드 검색: 밀집 벡터 + BM25 키워드 검색
- RRF 퓨전: 상호 순위 퓨전으로 결과 결합
- 시맨틱 검색: 개념적 쿼리 검색
- 정확 일치: 식별자 및 키워드 정확 매칭
- 크로스 프로젝트 검색
코드 그래프 및 분석
- 다국어(Polyglot) 의존성 그래프
- 순환 의존성 탐지
- 그래프 시각화: Mermaid 또는 대화형 HTML
- 심볼 레벨 영향도 분석 (Blast Radius)
- 호출 흐름 추적 (Call-flow tracing)
- 파일 간 의존성 쿼리
인덱싱 및 런타임
- 증분 인덱싱 (Incremental indexing)
- 체크포인트 기반 재개 가능 인덱싱
- 대규모 리포지토리 배치 처리
- 라이브 파일 감시 (Live file watching)
- 멀티 에이전트 공유 인덱스
- 크로스 프로세스 락킹
지원 호스트 / 통합
- Claude Code (플러그인 권장)
- Claude Desktop, Cursor, VS Code Copilot
- Zed, Windsurf, Cline, Roo Code
- OpenCode, OpenAI Codex CLI
- 기타 MCP 호환 호스트
설치 및 설정
요구사항
- Docker 실행 중 필요
- Node.js 18+
MCP 설정 (기본)
"socratiCode": {
"command": "npx",
"args": ["-y", "socratiCode"]
}Claude Code 플러그인 설치
claude plugin marketplace add giancarloerra/socratiCode
claude plugin install socratiCode@socratiCode첫 사용 시 동작
- Docker 확인
- Qdrant 및 Ollama 컨테이너 풀
- 임베딩 모델 다운로드 (초기 설정은 연결 속도에 따라 약 5분 소요)
기술 스택
- 주언어: TypeScript (92.3%)
- 라이선스: AGPL-3.0
- 기반 기술: Docker, Qdrant (벡터 DB), Ollama (임베딩), MCP (Model Context Protocol)
관련 주제
ai, ai-assistant, ast, claude, claude-code, code-graph, codebase-intelligence, context-engine, docker, embeddings, gemini, gemini-cli-extension, mcp, openai, qdrant, semantic-search, vector-database, vector-embeddings, vector-search