零服务器代码智能引擎，将代码库索引为知识图谱，通过 MCP 协议为 AI Agent 提供深度架构理解与调用链追踪能力。
项目定位#
GitNexus 是一款零服务器代码智能引擎，核心目标是为 AI Agent 提供对代码库的深度架构理解。通过将代码索引为知识图谱，结合 MCP（Model Context Protocol）协议，使 AI 编程工具能够真正"理解"代码结构而非仅做表面匹配。
核心能力#
知识图谱构建#
- 基于 Tree-sitter 的多语言 AST 解析（支持 TypeScript、JavaScript、Python、Java、C、C++、C#、Go、Rust 共 9 种语言）
- 跨文件依赖追踪与调用链分析
- 功能聚类检测与执行流追踪（Processes）
MCP 工具集（7 个核心工具）#
| 工具 | 功能 |
|---|---|
list_repos | 发现所有已索引仓库 |
query | 混合搜索（BM25 + 语义 + RRF），按 Process 分组 |
context | 360° 符号视图——分类引用、Process 参与 |
impact | 影响范围分析（爆破半径），按深度分组 |
detect_changes | Git diff 影响映射——变更行到受影响 Process |
rename | 多文件协同重命名（图谱+文本搜索） |
cypher | 原生 Cypher 图查询 |
Agent Skills#
自动安装到 .claude/skills/ 目录的预置技能：
- Exploring — 使用知识图谱导航陌生代码
- Debugging — 通过调用链追踪 Bug
- Impact Analysis — 变更前分析影响范围
- Refactoring — 基于依赖映射规划安全重构
Resources 与 Prompts#
- Resources:
gitnexus://repos、gitnexus://repo/{name}/context、gitnexus://repo/{name}/clusters、gitnexus://repo/{name}/processes、gitnexus://repo/{name}/schema - Prompts:
detect_impact（预提交变更分析）、generate_map（架构文档生成含 Mermaid 图）
运行模式#
- CLI 模式：通过 npx 本地运行，支持索引、MCP 服务、Wiki 生成
- Web UI 模式：在线版零安装（拖放 ZIP 即可），或本地运行支持 Bridge Mode 连接 CLI 索引
- Bridge Mode：
gitnexus serve启动本地 HTTP 服务器，连接 CLI 与 Web UI，复用索引数据
安装与快速开始#
# 索引仓库（在仓库根目录执行）
npx gitnexus analyze
# 配置 MCP（一次性）
npx gitnexus setup
gitnexus analyze 一步完成：索引代码库、安装 Agent Skills、注册 Claude Code Hooks、创建 AGENTS.md / CLAUDE.md 上下文文件。
MCP 配置示例#
Claude Code（完整支持）：
claude mcp add gitnexus -- npx -y gitnexus@latest mcp
Cursor（~/.cursor/mcp.json）：
{
"mcpServers": {
"gitnexus": {
"command": "npx",
"args": ["-y", "gitnexus@latest", "mcp"]
}
}
}
典型应用场景#
| 场景 | 价值 |
|---|---|
| AI 辅助编程 | 为 Claude Code、Cursor、Windsurf 等 AI 编程工具提供代码库完整上下文 |
| 影响分析 | 修改前预知影响范围（如修改 UserService.validate() 可预知 47 个依赖函数受影响） |
| 代码探索 | 通过可视化知识图谱快速理解陌生代码库 |
| 重构规划 | 基于依赖图安全规划重构路径 |
| 文档生成 | 从知识图谱自动生成 LLM 驱动的架构文档（含 Mermaid 图） |
| 变更检测 | Pre-commit 阶段分析 Git diff 对 Process 的影响 |
架构要点#
- 图数据库：KuzuDB（嵌入式，支持 native 与 WASM）
- AST 解析：Tree-sitter（多语言支持）
- 向量嵌入：HuggingFace transformers.js（支持 GPU/CPU 与 WebGPU/WASM）
- 搜索算法：BM25 + 语义向量 + RRF 融合排序
- 可视化：Sigma.js + Graphology（WebGL 渲染）
- 前端框架：React 18、TypeScript、Vite、Tailwind v4
多仓库架构#
- 每个仓库内
.gitnexus/存储索引 - 全局注册表位于
~/.gitnexus/registry.json - 单个 MCP 服务器可服务所有已索引仓库
- KuzuDB 连接懒加载，5 分钟无活动后驱逐（最大 5 并发）