axon：基于知识图谱的代码智能引擎

在大型代码库中导航和理解代码结构一直是开发者的痛点。今天要介绍的 axon 是一个将代码库索引为知识图谱的代码智能引擎，它通过 MCP（Model Context Protocol）工具为 AI 代理提供支持，同时也为开发者提供了强大的 CLI 工具。

项目概览

属性	详情
GitHub	harshkedia177/axon
Stars	659 ⭐
语言	Python
创建时间	2026年2月
许可证	N/A

核心概念

axon 的创新之处在于它将传统的代码分析提升到了一个新的层次：

知识图谱索引

不同于简单的文本搜索，axon 将代码库解析为结构化的知识图谱：

• 实体识别：函数、类、变量、模块等代码元素
• 关系映射：调用关系、继承关系、依赖关系
• 语义关联：理解代码的业务逻辑和意图

MCP 工具集成

axon 实现了 Model Context Protocol，这意味着：

• AI 代理可以通过标准化接口查询代码库
• 工具调用的结果可以被 LLM 理解和利用
• 支持代码分析、重构建议、死代码检测等场景

技术架构

┌─────────────────────────────────────────┐
│           代码库 (Codebase)              │
└─────────────┬───────────────────────────┘
              │ 解析
              ▼
┌─────────────────────────────────────────┐
│      Tree-sitter 语法分析器              │
│  (支持 Python, TypeScript 等)           │
└─────────────┬───────────────────────────┘
              │ AST
              ▼
┌─────────────────────────────────────────┐
│         知识图谱构建引擎                  │
│   (实体提取 + 关系建模)                   │
└─────────────┬───────────────────────────┘
              │ 图谱数据
              ▼
┌─────────────────────────────────────────┐
│      查询接口 (MCP + CLI)                │
└─────────────────────────────────────────┘

核心功能

1. 代码智能分析

• 函数调用链追踪：快速了解一个函数被谁调用、调用了谁
• 依赖关系可视化：模块间的依赖关系一目了然
• 影响范围分析：修改某处代码会影响哪些其他部分

2. 死代码检测

通过静态分析和图谱遍历，axon 可以识别：

• 未被调用的函数
• 不可达的分支代码
• 仅被测试代码使用的”伪使用”函数

3. AI 代理支持

# 通过 MCP 工具查询代码库
response = await mcp_client.call_tool(
    "axon/search",
    {"query": "查找所有处理用户认证的函数"}
)

安装与使用

# 克隆仓库
git clone https://github.com/harshkedia177/axon.git
cd axon

# 安装依赖
pip install -r requirements.txt

# 索引代码库
python -m axon index /path/to/your/codebase

# 启动 MCP 服务器
python -m axon serve

使用场景

场景一：新成员快速上手

新员工加入团队时，可以通过 axon 快速了解：

• 项目的核心模块和入口点
• 关键业务逻辑的分布
• 代码的调用流程和执行路径

场景二：代码重构

在进行大规模重构前，使用 axon 分析：

• 待重构模块的依赖关系
• 潜在的影响范围
• 推荐的重构顺序

场景三：AI 辅助开发

集成到 Claude Code 或其他 MCP 客户端：

用户: "这个函数的参数是做什么用的？"
AI: [通过 axon 查询函数定义和调用上下文]
    "根据代码库分析，这个参数用于..."

同类项目对比

工具	特点	与 axon 的区别
Sourcegraph	企业级代码搜索	axon 更轻量，专注知识图谱
GitHub Copilot	AI 代码补全	axon 提供代码库级上下文
LSP (Language Server)	编辑器支持	axon 提供跨文件的图谱关系

发展前景

axon 发布于 2026 年 2 月，在短短两个月内获得了 659 个 star，显示出开发者对代码智能工具的强烈需求。项目的几个发展方向值得关注：

1. 更多语言支持：目前支持 Python 和 TypeScript，计划扩展到更多语言
2. IDE 集成：VS Code 和 JetBrains 插件开发中
3. 可视化界面：基于图谱的代码浏览器

总结

axon 代表了代码分析工具的一个新方向——从简单的文本搜索走向语义化的知识图谱。对于需要频繁在大型代码库中工作的开发者，或者正在构建 AI 辅助开发工具的开发者来说，axon 值得关注和尝试。

---

参考链接

• GitHub: https://github.com/harshkedia177/axon
• MCP 协议: https://modelcontextprotocol.io