bartolli/codanna

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），在研发和配对编程时，需要在大型代码库中进行深度、上下文感知的导航和搜索。

Highlights

• Semantic Search: 使用自然语言查询，依据功能和行为查找函数与逻辑。
• Relationship Tracking: 实时提供跨文件的调用图和依赖分析。
• Document Search: 索引 markdown 和文本文件，支持 RAG 工作流，能够同时查询文档和代码。
• MCP Protocol Integration: 通过 Model Context Protocol 与 Claude、Gemini、Codex 原生兼容。
• High Performance: 每秒可解析 75,000+ 符号，查询延迟低于 10ms。