Docdex: 로컬 저장소를 AI를 위한 빠르고 안전한 프라이빗 컨텍스트로 변환

섹션별 상세

Docdex는 로컬 우선(Local-first) 방식을 채택하여 코드 프라이버시를 완벽하게 보호한다. 클라우드 벡터 저장소에 코드를 업로드할 필요 없이 사용자의 머신에서 직접 인덱싱을 수행하며, 이는 기업의 보안 정책을 준수하면서 AI 도구를 활용하려는 개발자에게 최적의 솔루션을 제공한다.

bash

npm i -g docdex

# Index a Repository
docdexd index --repo /path/to/my-project

# Start the Daemon
docdex start

Docdex 설치 및 저장소 인덱싱, 데몬 실행을 위한 기본 명령어

단순한 문자열 매칭을 넘어 AST(추상 구문 트리)와 영향도 그래프(Impact Graph)를 활용한 코드 지능을 제공한다. Rust, Python, JS/TS 등 다양한 언어를 지원하며, 특정 함수의 정의를 찾거나 코드 변경 시 영향을 받는 하위 의존성을 추적하는 등 AI가 코드의 논리적 구조를 이해하도록 돕는다.

bash

# Find definition
curl "http://127.0.0.1:28491/v1/ast?name=addressGenerator&pathPrefix=src"

# Track downstream impact
curl "http://127.0.0.1:28491/v1/graph/impact?file=src/app.ts&maxDepth=3"

HTTP API를 사용한 AST 정의 검색 및 영향도 분석 요청 예시

프로젝트별 '저장소 메모리'와 사용자별 '에이전트 메모리' 시스템을 갖추고 있다. 특정 프로젝트의 결정 사항이나 팩트를 저장하여 나중에 회상할 수 있게 하며, 사용자의 답변 스타일 선호도(예: '간결한 불렛 포인트 사용')를 여러 저장소에 걸쳐 유지함으로써 일관된 AI 경험을 제공한다.

MCP(Model Context Protocol)를 네이티브로 지원하여 다양한 AI 클라이언트와 원활하게 통합된다. Claude Desktop, Cursor, Windsurf, VS Code 등 주요 도구들을 자동으로 감지하고 설정하며, HTTP/SSE 엔드포인트를 통해 AI 에이전트가 Docdex를 자신의 '두뇌'처럼 활용할 수 있게 한다.

json

{
  "mcpServers": {
    "docdex": {
      "url": "http://127.0.0.1:28491/v1/mcp/sse"
    }
  }
}

Claude나 Cursor 등 MCP 클라이언트를 위한 수동 설정 예시

Ollama와의 연동을 통해 로컬 LLM 및 임베딩 모델을 활용할 수 있다. nomic-embed-text와 같은 모델을 사용하여 로컬에서 임베딩을 생성하고 검색을 수행하며, 필요한 경우 로컬 LLM을 통한 필터링 기능이 포함된 웹 검색 강화 기능도 제공한다.

용어 해설

추상 구문 트리(AST): — 프로그래밍 언어로 작성된 소스 코드의 구조를 트리 형태로 표현한 것이다. 단순한 텍스트 매칭을 넘어 코드의 논리적 구조와 문법적 관계를 파악할 수 있게 하여 AI가 코드의 의미를 깊이 있게 이해하도록 돕는다.
모델 컨텍스트 프로토콜(MCP): — AI 에이전트가 외부 도구나 데이터 소스와 통신하기 위한 표준 프로토콜이다. Docdex는 이를 통해 Claude Desktop이나 Cursor 같은 다양한 AI 클라이언트와 로컬 데이터를 연결하는 가교 역할을 수행한다.
검색 증강 생성(RAG): — 외부 지식 베이스에서 관련 정보를 검색하여 LLM의 답변 생성에 활용하는 기법이다. Docdex는 이를 로컬 환경에서 구현하여 코드 유출 없이 정확한 컨텍스트를 AI에게 제공한다.
데몬(Daemon): — 사용자가 직접 제어하지 않고 백그라운드에서 실행되며 특정 서비스를 제공하는 프로그램이다. Docdex는 데몬 형태로 실행되어 여러 IDE나 AI 에이전트의 요청을 동시에 처리하는 서버 역할을 한다.
영향도 그래프(Impact Graph): — 특정 코드 변경이 시스템의 다른 부분에 미치는 영향을 시각화하거나 추적하는 구조다. 함수 간의 의존성을 분석하여 코드 수정 시 발생할 수 있는 부작용을 AI가 미리 파악할 수 있게 한다.

기술

Docdex
Ollama
Rust
Node.js
MCP
nomic-embed-text

활용 사례

프라이빗 코드 저장소의 AI 컨텍스트 제공
복잡한 코드베이스의 영향도 분석 보조
AI 에이전트용 지속적 메모리 시스템 구축

언급된 리소스

문서Docdex Website

GitHubDocdex GitHub Repository

섹션별 상세

bash

npm i -g docdex

# Index a Repository
docdexd index --repo /path/to/my-project

# Start the Daemon
docdex start

Docdex 설치 및 저장소 인덱싱, 데몬 실행을 위한 기본 명령어

bash

# Find definition
curl "http://127.0.0.1:28491/v1/ast?name=addressGenerator&pathPrefix=src"

# Track downstream impact
curl "http://127.0.0.1:28491/v1/graph/impact?file=src/app.ts&maxDepth=3"

HTTP API를 사용한 AST 정의 검색 및 영향도 분석 요청 예시

json

{
  "mcpServers": {
    "docdex": {
      "url": "http://127.0.0.1:28491/v1/mcp/sse"
    }
  }
}

Claude나 Cursor 등 MCP 클라이언트를 위한 수동 설정 예시

용어 해설

추상 구문 트리(AST): — 프로그래밍 언어로 작성된 소스 코드의 구조를 트리 형태로 표현한 것이다. 단순한 텍스트 매칭을 넘어 코드의 논리적 구조와 문법적 관계를 파악할 수 있게 하여 AI가 코드의 의미를 깊이 있게 이해하도록 돕는다.
모델 컨텍스트 프로토콜(MCP): — AI 에이전트가 외부 도구나 데이터 소스와 통신하기 위한 표준 프로토콜이다. Docdex는 이를 통해 Claude Desktop이나 Cursor 같은 다양한 AI 클라이언트와 로컬 데이터를 연결하는 가교 역할을 수행한다.
검색 증강 생성(RAG): — 외부 지식 베이스에서 관련 정보를 검색하여 LLM의 답변 생성에 활용하는 기법이다. Docdex는 이를 로컬 환경에서 구현하여 코드 유출 없이 정확한 컨텍스트를 AI에게 제공한다.
데몬(Daemon): — 사용자가 직접 제어하지 않고 백그라운드에서 실행되며 특정 서비스를 제공하는 프로그램이다. Docdex는 데몬 형태로 실행되어 여러 IDE나 AI 에이전트의 요청을 동시에 처리하는 서버 역할을 한다.
영향도 그래프(Impact Graph): — 특정 코드 변경이 시스템의 다른 부분에 미치는 영향을 시각화하거나 추적하는 구조다. 함수 간의 의존성을 분석하여 코드 수정 시 발생할 수 있는 부작용을 AI가 미리 파악할 수 있게 한다.

기술

Docdex
Ollama
Rust
Node.js
MCP
nomic-embed-text

활용 사례

프라이빗 코드 저장소의 AI 컨텍스트 제공
복잡한 코드베이스의 영향도 분석 보조
AI 에이전트용 지속적 메모리 시스템 구축

언급된 리소스

문서Docdex Website

GitHubDocdex GitHub Repository

Docdex: 로컬 저장소를 AI를 위한 빠르고 안전한 프라이빗 컨텍스트로 변환

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

Docdex: 로컬 저장소를 AI를 위한 빠르고 안전한 프라이빗 컨텍스트로 변환

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드