将多语言代码库解析为知识图谱,通过 AI 智能体或 MCP 服务用自然语言查询、检索和编辑代码。
ix-infrastructure/Ix
Ix 将代码仓库解析为持久化的符号、调用与导入关系图,供开发者和 AI 编程代理查询结构。
- Star
- 1,097
- Fork
- 82
- 未关闭 Issue
- 25
- 最近提交
- 昨天
这是什么?
Ix 是一款命令行工具,将代码库映射为由符号、调用、导入和包含关系组成的图谱。它使用 tree-sitter 解析仓库,并把结果存入本地后端,图谱在多次会话之间保持不变,无需每次通过搜索重新梳理。
通过 CLI 可以查询某个符号的作用、被谁调用、依赖什么,以及修改后会影响哪些部分。输出支持纯文本、JSON 和面向大模型的精简格式。内置的 MCP 服务器可把同一张图谱提供给 Claude Code、Codex、Cursor、VS Code 等支持 MCP 的客户端,`ix view` 则会打开名为 Compass 的可视化界面。
后端以 Docker 镜像形式运行,基于 ArangoDB 与记忆层。安装脚本会自动补齐缺失的 Node.js、ripgrep 和 Docker。预编译 CLI 覆盖 Apple Silicon macOS、Linux 与 Windows x86-64,Intel Mac 可通过 Homebrew 从源码构建。
核心功能
- 01借助 tree-sitter 将仓库解析为符号、调用和导入关系。
- 02在本地持久保存代码图谱,跨会话复用。
- 03支持 explain、trace、impact、callers 等针对单个符号的查询。
- 04提供 MCP 服务器,并可自动注册到多款 AI 客户端。
- 05支持 27 种编程语言以及多种配置与数据格式。
适用场景
- 快速熟悉一个陌生的代码库。
- 在修改函数前评估可能受影响的范围。
- 让编程代理获取结构化上下文,而不必粘贴整个文件。
- 通过依赖关系排名找出核心模块。
快速上手
- 1
运行 README 中的官方安装脚本(macOS/Linux)
- 2
解析一个代码仓库
ix map . - 3
将你的 AI 客户端注册到 MCP 服务器
ix mcp install
使用前须知
- 需要 Docker 和 Docker Compose 来运行本地 ArangoDB 后端。
- 安装脚本通过管道直接执行远程脚本,Intel Mac 需要通过 Homebrew 从源码构建。
标签
常见问题
- Ix 是什么?
- Ix 将代码仓库解析为持久化的符号、调用与导入关系图,供开发者和 AI 编程代理查询结构。 Ix 是一款命令行工具,将代码库映射为由符号、调用、导入和包含关系组成的图谱。它使用 tree-sitter 解析仓库,并把结果存入本地后端,图谱在多次会话之间保持不变,无需每次通过搜索重新梳理。
- Ix 可以免费使用吗?用的什么许可证?
- Ix 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- Ix 还在维护吗?
- 活跃维护中。Ix 最近一次提交是在 2026年10月21日。
- Ix 适合用来做什么?
- 快速熟悉一个陌生的代码库。 在修改函数前评估可能受影响的范围。 让编程代理获取结构化上下文,而不必粘贴整个文件。 通过依赖关系排名找出核心模块。
- Ix 怎么安装和运行?
- 运行 README 中的官方安装脚本(macOS/Linux) 解析一个代码仓库: ix map . 将你的 AI 客户端注册到 MCP 服务器: ix mcp install
- 在哪里获取 Ix?
- 源代码和安装说明在 GitHub 上:https://github.com/ix-infrastructure/Ix
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一个命令行工具,扫描代码库并生成精简的 AI 上下文文件,减少编程助手探索项目时消耗的 token。
将整个代码仓库打包成单个 AI 友好文件,方便输入给 Claude、ChatGPT 等大模型的命令行与网页工具。
将代码库索引为依赖、调用链与执行流程的知识图谱,并通过 MCP 工具供 AI 编程助手调用。
一个 MCP 服务器,将代码、文档与基础设施索引为本地知识图谱,让 AI 编程代理查询结构而非反复读取文件。
把代码、文档、SQL 表结构和 PDF 转成可查询的知识图谱,供 AI 编程助手使用。