Docdex: 로컬 기반의 고성능 코드 및 문서 인덱서 및 검색 데몬

핵심 요약

기존 AI 도구들은 단순한 문자열 검색(grep)에 의존하거나 보안 위험이 있는 클라우드 기반 RAG 방식을 사용한다. Docdex는 이를 해결하기 위해 로컬에서 직접 코드와 문서를 인덱싱하고 검색 데몬을 실행하는 방식을 취한다. 추상 구문 트리(AST)와 임팩트 그래프를 활용해 코드의 의도와 의존성을 파악하며, Model Context Protocol(MCP)을 통해 다양한 AI 에디터와 즉시 연동된다. 결과적으로 개발자는 코드 유출 걱정 없이 AI 에이전트에게 고도화된 코드 이해력과 프로젝트별 영구 메모리를 제공할 수 있다.

배경

Node.js >= 18, Ollama (임베딩 모델 실행용), 기본적인 CLI 및 API 호출 지식

대상 독자

로컬 보안을 중시하며 AI 에이전트나 Cursor 같은 도구를 활용하는 소프트웨어 엔지니어

의미 / 영향

클라우드 의존적인 AI 개발 환경에서 로컬 중심의 프라이버시 보호형 도구로의 전환을 가속화할 것이다. 특히 보안이 중요한 기업 환경에서 AI 도입의 장벽을 낮추는 역할을 할 것으로 기대된다.

섹션별 상세

Docdex는 클라우드 벡터 저장소에 코드를 업로드하지 않고 로컬에서 모든 인덱싱과 검색을 수행한다. 이는 기업의 소스 코드 보안을 유지하면서도 AI 에이전트에게 필요한 정보를 제공할 수 있게 한다. 단순한 문자열 매칭을 넘어 코드의 의도를 파악하는 랭킹 시스템을 통해 정확한 컨텍스트를 추출한다.

단순 검색을 넘어 추상 구문 트리(AST)와 임팩트 그래프(Impact Graph)를 활용하여 코드 구조를 분석한다. 특정 함수의 정의를 찾거나 코드 변경 시 영향을 받는 하위 의존성을 추적하는 기능을 제공한다. Rust, Python, JS/TS, Go, Java 등 다양한 주요 프로그래밍 언어를 지원하여 기술적 깊이가 있는 코드 인텔리전스를 구현한다.

Model Context Protocol(MCP)을 기본적으로 지원하여 Claude Desktop, Cursor, Windsurf 등 최신 AI 도구와 즉시 연동된다. 설치 시 자동으로 클라이언트 설정을 구성하며 HTTP/SSE 및 IPC 방식을 통해 AI 에이전트와 통신한다. 이를 통해 개발자는 별도의 복잡한 설정 없이 기존 워크플로우에 Docdex를 통합할 수 있다.

프로젝트별 결정 사항이나 사실을 저장하는 Repo Memory와 사용자 선호도를 기억하는 Agent Memory 시스템을 갖추고 있다. 예를 들어 특정 결제 정책이나 선호하는 코드 스타일을 저장해두면 AI 에이전트가 이를 나중에 다시 불러와 일관된 답변을 제공할 수 있다. 이는 단순 검색을 넘어 AI에게 장기 기억 능력을 부여하는 역할을 한다.

</> 코드 예제 포함

실무 Takeaway

로컬 환경에서 RAG를 구현하여 데이터 유출 걱정 없이 AI 도구의 성능을 극대화할 수 있다.
AST 기반 분석을 통해 단순 검색으로는 찾기 힘든 코드 간의 복잡한 의존성 관계를 AI에게 전달한다.
MCP 표준을 활용해 다양한 AI 에디터와 에이전트를 하나의 로컬 지식 베이스에 통합 관리한다.

언급된 리소스

GitHubDocdex GitHub Repository

API DocsDocdex HTTP API Reference