Appearance
GitNexus:零服务器代码智能引擎,让AI代理真正理解你的代码库
一个完全在浏览器中运行的代码知识图谱引擎。只需拖入GitHub仓库或ZIP文件,即可生成交互式知识图谱,让AI代理获得架构级代码理解能力。
项目简介
用Cursor、Claude Code或Codex时,经常遇到AI"盲改"代码的问题——修改一个函数却破坏了调用链,重构一个模块遗漏了依赖关系。GitNexus正是为解决这个痛点而生。
它将代码库索引为知识图谱,追踪每一个依赖、调用链、模块聚类和执行流程,然后通过MCP协议将这些信息暴露给AI代理。
| 项目信息 | 数据 |
|---|---|
| ⭐ Stars | 32.2k |
| 🔧 语言 | TypeScript |
| 📅 创建 | 2025年8月 |
| 👤 开发者 | abhigyanpatwari |
| 🔗 GitHub | abhigyanpatwari/GitNexus |
| 🏠 在线体验 | gitnexus.vercel.app |
两种使用方式
| 维度 | CLI + MCP | Web UI |
|---|---|---|
| 用途 | 本地索引,通过MCP连接AI代理 | 浏览器中可视化图谱+AI对话 |
| 场景 | 与Cursor/Claude Code/Codex日常开发 | 快速探索、演示、一次性分析 |
| 规模 | 支持任意大小仓库 | 约5k文件(浏览器内存限制) |
| 安装 | npm install -g gitnexus | 无需安装,浏览器访问 |
| 隐私 | 完全本地,无网络请求 | 完全浏览器内,无服务器 |
两种模式可通过 gitnexus serve 桥接。
核心功能
知识图谱索引
使用Tree-sitter解析代码,构建包含以下关系的知识图谱:
| 关系类型 | 说明 |
|---|---|
| 依赖关系 | import、require、include |
| 调用链 | 函数/方法调用追踪 |
| 模块聚类 | Leiden社区检测识别功能区域 |
| 执行流程 | 端到端流程追踪 |
16个MCP工具
通过MCP协议暴露工具,让AI代理获得深度代码感知:
| 工具 | 功能 |
|---|---|
| query | 混合搜索(BM25+语义+RRF) |
| context | 360°符号视图 |
| impact | 影响范围分析,深度分组和置信度 |
| detect_changes | Git diff影响映射 |
| rename | 多文件协同重命名 |
| cypher | 原生Cypher图查询 |
| group_sync | 跨仓库提取契约 |
| group_query | 跨仓库搜索执行流程 |
影响范围分析
修改代码前,AI代理可以精确知道:
- 哪些函数会受影响
- 影响传播深度(1跳、2跳、3跳)
- 受影响的执行流程
- 置信度评分
自动生成代码Wiki
bash
gitnexus wiki基于知识图谱自动生成仓库文档,包含Mermaid图表,始终与代码保持同步。
使用方法
bash
# 安装
npm install -g gitnexus
# 索引当前仓库
gitnexus index
# 启动MCP服务器(供AI代理连接)
gitnexus serve
# 生成代码Wiki
gitnexus wiki集成方式
| AI工具 | 集成方式 |
|---|---|
| Cursor | MCP配置接入 |
| Claude Code | MCP配置接入 |
| Codex | MCP配置接入 |
| 任何支持MCP的Agent | 直接连接 |
关键词:GitNexus, 知识图谱, 代码分析, MCP, 代码理解, AI Agent, Tree-sitter
