Codanna MCP server
2026년 10월 11일 커밋AI 코딩 에이전트가 코드를 의미론적으로 검색하고 호출 그래프, 의존성 및 영향도를 추적할 수 있도록 로컬 저장소를 인덱싱합니다.
다른 이름 bartolli/codanna
- 스타
- 760
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 11일
- 라이선스
- Apache-2.0
Codanna MCP란?
AI 코딩 에이전트가 코드를 의미론적으로 검색하고 호출 그래프, 의존성 및 영향도를 추적할 수 있도록 로컬 저장소를 인덱싱합니다.
프로젝트 README에서 생성된 요약
Codanna MCP server 정보
AI 코딩 에이전트를 사용하는 개발자는 codanna를 통해 어시스턴트에게 로컬 저장소에 대한 깊은 구조적 지식을 제공할 수 있습니다. 이 도구는 코드베이스를 인덱싱하여 의미론적 검색, 호출 그래프 추적 및 의존성 분석을 가능하게 합니다. stdio, HTTP 또는 HTTPS를 통해 지속적인 MCP server로 실행하거나, 스크립트 및 CI 환경을 위한 원샷 CLI로 작동합니다. Claude Code, Cursor, Windsurf, Gemini, Codex와 같은 클라이언트와 호환됩니다.
파일을 로컬에서 인덱싱함으로써, 이 서버는 소스 코드를 원격 API로 전송하지 않고도 에이전트가 영향 분석 및 문서 RAG와 같은 복잡한 작업을 수행할 수 있도록 합니다. 시스템은 Rust, Python, TypeScript, Go를 포함한 15개 언어를 지원합니다. 기본적으로 로컬에서 실행되지만, 사용자는 환경 변수를 구성하여 OpenAI 호환 원격 임베딩을 선택적으로 사용할 수 있습니다. 이 도구는 심볼 식별자, 시그니처, 코드 변경의 영향 범위(blast radius)와 같은 구체적인 통찰력을 제공하여, 기존의 grep 후 읽기 과정을 하나의 구조화된 응답으로 효과적으로 통합합니다.
활용 사례
- 1코드 변경 영향 분석특정 함수를 수정할 경우 어떤 심볼이 영향을 받는지 에이전트에게 확인합니다.
- 2함수 관계 추적특정 메서드를 호출하는 함수가 정확히 무엇인지, 그리고 해당 호출이 어디에서 발생하는지 식별합니다.
- 3프로젝트 문서 쿼리마크다운 및 텍스트 파일을 검색하여 인증 흐름이나 기타 프로젝트 세부 정보에 대한 정보를 찾습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능bartolli/codanna is public and reachablegithub.com/bartolli/codanna ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-11github.com/bartolli/codanna ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Local code intelligence MCP server and CLI for AI coding agents.
X-ray vision for your agent.
Codanna is a local code intelligence and semantic code search MCP server for AI coding agents. One MCP call returns symbol context, call graph, and impact analysis, pre-correlated — the grep-and-read loop your agent runs today, collapsed into a single response it can act on.
It indexes your repository on disk and serves symbol search, semantic search, call graphs, dependency tracking, document RAG, and impact analysis to Claude Code, Cursor, Windsurf, Codex, Gemini, and any MCP-compatible client — as a persistent MCP server for session-long work, or a one-shot CLI for instant answers when LSP is too slow. Written in Rust. 15 languages. No source code leaves your machine.
Two operational modes
Codanna's MCP toolset is reachable two ways. Same tools, same surface — pick the mode that fits the workflow.
Persistent MCP server — for session-long agent workflows.
codanna serve # stdio
codanna serve --http # HTTP
codanna serve --https # HTTPS
One-shot CLI — for slash-commands, bash hooks, scripts, CI. No daemon required.
codanna mcp find_symbol name:"my_function"
codanna mcp analyze_impact symbol_name:"my_function"
codanna mcp semantic_search_with_context query:"recursively extract function calls"
codanna mcp semantic_search_with_context is the headline command: it returns N semantic matches, and for each match the symbol identity, signature, docstring, callees, callers, and recursive impact analysis — five MCP tools fused into one query.
The one-shot CLI is also what makes codanna skill-friendly: an Agent Skill can wrap codanna mcp commands directly in Claude Code, Cursor, Windsurf, Codex, Gemini, or any harness that runs shell commands — no MCP plumbing required.
What one call returns
The headline command, run against codanna's own source tree. One call, and the agent has the symbol, its documentation, signature, callees with exact call sites, callers, and blast radius:
$ codanna mcp semantic_search_with_context query:"recursively extract function calls" limit:1
Found 1 results for query: 'recursively extract function calls'
1. extract_calls_recursive - Method at src/parsing/cpp/parser.rs:1002-1047 [symbol_id:1477]
Similarity Score: 0.833
Documentation:
Recursively extract function calls with context tracking
Signature: fn extract_calls_recursive<'a>(
node: Node,
code: &'a str,
current_function: Option<&'a str>,
calls: &mut Vec<(&'a str, &'a str, Range)>,
)
extract_calls_recursive calls 3 function(s):
-> Method extract_calls_recursive at src/parsing/cpp/parser.rs:1002 [symbol_id:1477] (called at src/parsing/cpp/parser.rs:1045)
-> Method function_name_at_def at src/parsing/cpp/parser.rs:377 [symbol_id:1451] (called at src/parsing/cpp/parser.rs:1008)
-> Method new at src/types/mod.rs:112 [symbol_id:7388] (called at src/parsing/cpp/parser.rs:1028)
2 function(s) call extract_calls_recursive:
<- Method extract_calls_recursive at src/parsing/cpp/parser.rs:1045 [symbol_id:1477]
<- Method find_calls at src/parsing/cpp/parser.rs:885 [symbol_id:1467]
Changing extract_calls_recursive would impact 1 symbol(s) (max depth: 2):
methods (1):
- find_calls [symbol_id:1467]
Guidance: Found one match with full context. Review the relationships to understand how this fits into the codebase.
Every result carries file:line coordinates the agent can open directly, symbol_ids it can reuse to disambiguate name collisions, and a guidance hint it can chain on. Add --json for the structured envelope.
Local-first
Codanna runs on your machine. The repository index lives on disk under .codanna/. The embedding model downloads once on first use, then runs locally. No source code, symbols, or queries are sent to a remote API by default. Remote OpenAI-compatible embeddings are opt-in: remote_url under [semantic_search] in settings.toml, or CODANNA_EMBED_* environment variables; the API key is environment-only.
Quick Start
Install (macOS, Linux, WSL)
curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | sh
Or via Homebrew
brew install codanna
Or via Nix
nix run github:bartolli/codanna
Windows (PowerShell)
irm https://raw.githubusercontent.com/bartolli/codanna/main/scripts/install.ps1 | iex
See Installation Guide for Cargo and other options.
Initialize and index
codanna init
codanna index src
Search code
codanna mcp semantic_search_with_context query:"where do we handle errors" limit:3
Search documentation (RAG)
codanna documents add-collection docs ./docs
codanna documents index
codanna mcp search_documents query:"authentication flow"
What It Does
Your AI assistant gains structured knowledge of your code:
- "Where's this function called?" - Instant call graph, not grep results
- "Find authentication logic" - Semantic search matches intent, not just keywords
- "What breaks if I change this?" - Full dependency analysis across files
The difference: Codanna understands code structure. It knows parseConfig is a function that calls validateSchema, not just a string match.
Features
| Feature | Description |
|---|---|
| Semantic Search | Natural language queries against code and documentation. Finds functions by what they do, not just their names. |
| Relationship Tracking | Call graphs, implementations, and dependencies. Trace how code connects across files. |
| Document Search | Index markdown and text files for RAG workflows. Query project docs alongside code. |
| MCP Protocol | Native integration with Claude, Gemini, Codex, and other AI assistants. |
| Profiles | Package hooks, commands, and agents for different project types. |
Performance: parser throughput 76,000-249,000 symbols/second depending on language; warm-server lookups under 10 ms (0.3 ms exact, ~3 ms semantic). Parsing is the fast layer; embedding generation during indexing takes longer and scales with your cores. Measured numbers, machine spec, and reproduction commands: Benchmarks.
Languages: Rust, Python, JavaScript, TypeScript, Java, Kotlin, Go, PHP, C, C++, C#, Clojure, Lua, Swift, GDScript.
Claude Code plugin
Two skills over the index, driven by the agent: it picks the view that fits the question. x-ray covers scoped questions — a symbol's blast radius as a call DAG, module structure as a collapsible tree or radial poster, cross-module calls as an edge-bundle page. graph covers codebase shape: the module disc with hubs at the centre, a commit timeline, and a heatmap. Symbol search, detail panels with highlighted signatures, call-graph navigation. The disc renderer is adapted from vault-graph by Lukas Proprentner (MIT).
/plugin marketplace add bartolli/codanna
/plugin install codanna-toolset@codanna
Integration
Add codanna to any MCP-compatible client. Project-scoped .mcp.json (Claude Code, Cursor, Windsurf):
{
"mcpServers": {
"codanna": {
"command": "codanna",
"args": ["--config", ".codanna/settings.toml", "serve", "--watch"]
}
}
}
--watch keeps the index hot as files change. Transports: stdio, HTTP, HTTPS. See Integration Guides for Claude Desktop, Gemini, Codex, and network setups.
Requirements
- ~150MB for embedding model (downloaded on first use)
- macOS: Apple Silicon. ONNX Runtime 1.28 has no Intel macOS build, so 0.17.1 and later do not target Intel Macs; 0.17.0 is the last release that does
- Linux: glibc 2.38+ and libstdc++ from GCC 13+ for
cargo install(the prebuilt ONNX Runtime binaries); the release binaries are built on Ubuntu 24.04 (glibc 2.39) - Build from source: Rust 1.85+ and
pkg-config - Windows support is experimental
Contributing
Contributions welcome. See CONTRIBUTING.md.
License
Apache License 2.0 - See LICENSE.
Attribution required. See NOTICE.
Built with Rust.
Codanna MCP 질문
Codanna가 소스 코드를 원격 API로 전송하나요?
아니요. Codanna는 .codanna/ 디렉토리에 로컬 디스크에서 저장소를 인덱싱하며 임베딩 모델을 로컬에서 실행합니다. 원격 임베딩은 설정을 통해 선택적으로 사용할 수 있습니다.
Codanna는 어떤 프로그래밍 언어를 지원하나요?
Codanna는 Rust, Python, JavaScript, TypeScript, Java, Go, C, C++, C#, Swift, PHP, Kotlin, Clojure, Lua, GDScript를 포함한 15개 언어를 파싱합니다.
지속적인 서버를 실행하지 않고도 Codanna를 사용할 수 있나요?
네. 원샷 CLI를 사용하면 스크립트, 훅 또는 CI에서 단일 명령어로 동일한 MCP 도구를 실행할 수 있습니다.
semantic_search_with_context는 무엇을 반환하나요?
심볼 식별자, 시그니처, docstring, 호출 대상(callees), 호출자(callers) 및 재귀적 영향 분석을 포함한 의미론적 검색 결과를 하나의 응답으로 반환합니다.
Codanna MCP server는 어떤 전송 방식을 지원하나요?
stdio, HTTP, HTTPS를 지원합니다.