bartolli/codanna

Local code intelligence MCP server and CLI for AI coding agents

What it solves

Codanna는 AI 어시스턴트에게 코드베이스에 대한 구조화된 이해를 제공하여 기본 키워드 검색(grep)과 반복적인 상호작용을 없앱니다. 에이전트는 함수 간 관계를 파악하고, 의존성을 추적하며, 이름이 아니라 의도에 따라 구현을 찾을 수 있습니다.

How it works

Codanna는 프로젝트의 소스 코드와 문서를 인덱싱합니다. 의미 검색을 사용해 자연어 쿼리를 코드 의도와 매칭하고, 파일 간 호출 그래프와 의존 관계를 추적합니다. Model Context Protocol(MCP)을 통해 AI 어시스턴트와 통합되며, stdio, HTTP, HTTPS 등 다양한 전송 방식을 지원합니다.

Who it’s for

대규모 코드베이스에서 깊이 있는 컨텍스트 인식 탐색 및 검색이 필요한 개발자와 AI 에이전트(Claude Code, Cursor, Windsurf 등)를 위한 도구입니다. 연구·개발(R&D) 및 페어 프로그래밍 시에 유용합니다.

Highlights

  • Semantic Search: 자연어 쿼리를 사용해 기능과 로직을 검색합니다.
  • Relationship Tracking: 파일 간 호출 그래프와 의존성 분석을 즉시 제공합니다.
  • Document Search: Markdown 및 텍스트 파일을 인덱싱해 코드와 함께 문서를 검색할 수 있는 RAG 워크플로를 지원합니다.
  • MCP Protocol Integration: Model Context Protocol을 통해 Claude, Gemini, Codex와 네이티브 호환됩니다.
  • High Performance: 초당 75,000개 이상의 심볼을 파싱하고, 조회 지연시간은 10ms 미만입니다.