Codanna MCPサーバー
コミット 2026年10月11日ローカルリポジトリをインデックス化し、AIコーディングエージェントによるコードのセマンティック検索、コールグラフ、依存関係、および影響範囲の追跡を可能にします。
別名 bartolli/codanna
- スター
- 760
- ツール
- —
- ダウンロード数(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プロジェクトドキュメントのクエリMarkdownやテキストファイルを検索して、認証フローやその他のプロジェクトの詳細に関する情報を探し出します。
プロジェクトの 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、呼び出し先、呼び出し元、および再帰的な影響分析を含むセマンティックな一致結果を、1つのレスポンスとして返します。
Codanna MCP serverはどのトランスポートをサポートしていますか?
stdio、HTTP、およびHTTPSをサポートしています。