bartolli/codanna
GitHub: bartolli/codanna
Codanna 是一个通过 MCP 协议为 AI 编码助手提供本地、高性能代码语义理解与关系追踪能力的工具。
Stars: 687 | Forks: 61
Codanna
[](#)
[](#)
[](#)
[](#)
[](#)
文档
·
报告问题
·
讨论
**为您的代理赋予X光视觉。**
赋予您的代码助手透视代码库的能力——理解函数、追踪关系，并以前所未有的精确度定位实现。上下文优先编程。告别无休止的grep循环。告别反复的来回沟通。只需更少的按键，即可实现更智能的工程实践。
专为快速研发和结对编程而生——当LSP响应太慢时提供即时答案。[了解更多](https://docs.codanna.sh/)
## 快速开始
### 安装（macOS、Linux、WSL）
```
curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | sh
```
### 或通过 Homebrew
```
brew install codanna
```
### 或通过 Nix
```
nix run github:bartolli/codanna
```
### Windows (PowerShell)
```
irm https://raw.githubusercontent.com/bartolli/codanna/main/scripts/install.ps1 | iex
```
有关 Cargo 和其他选项，请参阅[安装指南](https://docs.codanna.sh/installation)。
### 初始化与索引
```
codanna init
codanna index src
```
### 搜索代码
```
codanna mcp semantic_search_with_context query:"where do we handle errors" limit:3
```
### 搜索文档（RAG）
```
codanna documents add-collection docs ./docs
codanna documents index
codanna mcp search_documents query:"authentication flow"
```
## 功能说明
您的AI助手将获得代码库的结构化知识：
- **“这个函数在哪里被调用？”** - 即时生成调用图，而非grep结果
- **“查找认证逻辑”** - 语义搜索匹配意图，而非仅仅是关键词
- **“如果我修改这里，会破坏什么？”** - 跨文件的全面依赖分析
关键区别：Codanna理解代码结构。它知道 `parseConfig` 是一个调用了 `validateSchema` 的函数，而不仅仅是一个字符串匹配。
## 功能特性
| 功能 | 描述 |
|---------|-------------|
| **[语义搜索](https://docs.codanna.sh/features/semantic-search)** | 对代码和文档进行自然语言查询。根据功能而非仅名称查找函数。 |
| **[关系追踪](https://docs.codanna.sh/features/relationships)** | 调用图、实现和依赖关系。追踪代码在不同文件间的连接方式。 |
| **[文档搜索](https://docs.codanna.sh/features/document-search)** | 索引Markdown和文本文件以支持RAG工作流。将项目文档与代码一并查询。 |
| **[MCP协议](https://docs.codanna.sh/reference/mcp-quick)** | 与Claude、Gemini、Codex及其他AI助手原生集成。 |
| **[配置文件](https://docs.codanna.sh/features/collaboration)** | 为不同项目类型打包钩子、命令和代理。 |
**性能：** 亚10毫秒查找，每秒解析75,000+符号。
**支持语言：** Rust、Python、JavaScript、TypeScript、Java、Kotlin、Go、PHP、C、C++、C#、Clojure、Lua、Swift、GDScript。
## 集成
用于AI助手的MCP协议。兼容Claude Code、Cursor、Windsurf以及任何MCP兼容客户端。支持stdio、HTTP和HTTPS传输。
设置说明请参阅[集成指南](https://docs.codanna.sh/reference/mcp-quick)。
## 系统要求
- 嵌入模型约占用150MB（首次使用时下载）
- **从源代码构建：** 需要Rust 1.85+，Linux系统需要 `pkg-config libssl-dev`
- Windows支持处于实验阶段
## 许可证
Apache License 2.0 - 请参阅[许可证](LICENSE)。
需要注明出处。请参阅[声明](NOTICE)。
基于Rust构建。
标签：AI编码代理, AI辅助编程, IPv6支持, MCP服务器, RAG, Rust, 上下文优先编码, 上下文理解, 代码分析, 代码助手, 代码搜索, 代码智能, 代码理解, 凭证管理, 可视化界面, 威胁情报, 开发者工具, 快速研发, 数据管道, 文档搜索, 本地代码服务, 结对编程, 网络流量审计, 语义搜索, 软件工程, 通知系统