GitHub Trending

GitNexus - 零服务器代码知识图谱引擎

GitNexus 将任何代码库索引为知识图谱，通过 MCP 连接 AI 代理，使其真正理解代码架构。支持 14 种编程语言，提供影响分析、流程追踪、混合搜索等 16 个智能工具，让 AI 编程工具不再盲目编辑代码。

GitHub Trending 榜首 | 作者: Abhigyan Patwari | 语言: TypeScript | 今日新增 2,694 Stars | 总计 23,997 Stars

项目简介

GitNexus 的核心理念是"构建代理上下文的神经系统"。它将任何代码库索引为完整的知识图谱——跟踪每个依赖项、调用链、功能集群和执行流程——然后通过 MCP（Model Context Protocol）将图谱以智能工具的形式暴露给 AI 代理，使其不再遗漏代码。

简单来说，现有的 AI 编程工具（Cursor、Claude Code、Codex 等）虽然强大，但它们并不真正理解代码库的深层结构。当一个 AI 编辑了 UserService.validate()，它可能不知道有 47 个函数依赖这个返回类型，从而导致破坏性变更。GitNexus 正是为此而生。

两种使用方式

GitNexus 提供两种使用模式，满足不同场景需求：

CLI + MCP 模式（推荐）：本地索引仓库，通过 MCP 连接 AI 代理。适合日常开发，支持完整仓库任意大小，所有数据本地处理，无网络调用。一条命令即可完成全部设置：

1

npx gitnexus analyze

Web UI 模式：完全运行在浏览器中的可视化图谱探索器 + AI 聊天。无需安装，直接访问 gitnexus.vercel.app，拖放 ZIP 文件即可开始探索。代码永远不会离开浏览器，隐私完全保障。

两种模式还可以通过桥接模式互通：运行 gitnexus serve 后，Web UI 会自动检测本地服务器，直接浏览所有 CLI 索引的仓库。

核心创新：预计算的关系智能

与传统图谱 RAG 方案不同，GitNexus 的核心创新在于索引时预计算结构——聚类、流程跟踪、置信度评分——使得 AI 代理一次工具调用即可获得完整上下文，而不需要进行多轮图谱查询探索。

传统方法需要 LLM 发起 4 次以上的查询才能回答"什么依赖 UserService？"，而 GitNexus 的 impact 工具一次调用就返回完整答案：8 个调用者，3 个集群，全部 90%+ 置信度。

这种设计带来三个关键优势：

  • 可靠性：LLM 不会遗漏上下文，因为完整信息已包含在工具响应中
  • 令牌效率：无需 10 次查询链来理解一个函数
  • 模型民主化：较小的 LLM 也能胜任，因为工具承担了繁重工作

16 个智能工具

通过 MCP 暴露的 16 个工具覆盖了代码理解的各种场景：

  • query：流程分组的混合搜索（BM25 + 语义 + RRF 融合排序）
  • context：360 度符号视图——查看分类引用和流程参与度
  • impact：带深度分组和置信度的影响范围分析
  • detect_changes：Git 差异影响分析——将变更行映射到受影响的流程
  • rename：带图谱 + 文本搜索的多文件协调重命名
  • cypher：原始 Cypher 图谱查询，支持自定义图遍历

此外还有 7 个资源端点和 2 个 MCP 提示，用于即时上下文获取和工作流引导。

编辑器集成

GitNexus 支持主流 AI 编程工具，其中 Claude Code 获得最深入的集成（MCP 工具 + 代理技能 + PreToolUse/PostToolUse 钩子）：

编辑器 MCP 技能 钩子 支持程度
Claude Code 是 是 是 完整
Cursor 是 是 — MCP + 技能
Codex 是 是 — MCP + 技能
Windsurf 是 — — MCP
OpenCode 是 是 — MCP + 技能

14 种语言支持

GitNexus 支持 TypeScript、JavaScript、Python、Java、Kotlin、C#、Go、Rust、PHP、Ruby、Swift、C、C++、Dart 等 14 种编程语言，覆盖了导入解析、命名绑定、继承分析、类型注解、构造函数推断、框架检测等完整能力。

其中 TypeScript 和 Python 获得最全面的支持（9/10 能力项），包括配置文件解析和框架模式检测。

多仓库架构

GitNexus 采用全局注册表设计，一个 MCP 服务器可以为多个索引仓库服务。每个仓库的索引存储在项目内的 .gitnexus/ 目录（便携，自动 gitignore），全局注册表在 ~/.gitnexus/registry.json 中维护指针。连接池支持最多 5 个并发，5 分钟不活动后自动驱逐。

技术栈

CLI 端使用 Node.js 原生运行时、Tree-sitter 原生绑定、LadybugDB 原生图谱数据库。Web 端则完全基于 WebAssembly 实现（Tree-sitter WASM、LadybugDB WASM、transformers.js WebGPU/WASM），使用 React 18 + TypeScript + Vite + Tailwind v4 构建，Sigma.js + Graphology 实现 WebGL 图谱渲染。

安全与隐私

CLI 模式一切在本地运行，无网络调用。Web 模式一切在浏览器中运行，代码不上传到任何服务器。项目完全开源，代码可审计。采用 PolyForm Noncommercial 许可证，商业使用需获得适当许可（企业版另提供 SaaS 和自托管方案）。

项目地址