Agent之MCP：GitNexus的简介、安装和使用方法、案例应用之详细攻略
Agent之MCP：GitNexus的简介、安装和使用方法、案例应用之详细攻略
目录
GitNexus的简介
1、特点
GitNexus的安装和使用方法
1、安装
步骤一：进入需要分析的代码仓库根目录
步骤二：执行仓库分析命令：
步骤三：配置 MCP。
2、使用方法
（1）索引代码仓库
（2）启动 MCP 服务
（3）启动本地 HTTP 服务
（4）查看仓库状态
（5）管理索引
（6）生成 Wiki
（7）Repository Group 管理
GitNexus的案例应用
案例一：构建代码仓库知识图谱
案例二：为 AI 编辑器配置 MCP
案例三：启动 MCP 服务供 AI Agent 查询
案例四：生成仓库 Wiki
案例五：管理多仓库项目
GitNexus的简介
GitNexus 是一个面向 AI 智能体的代码智能（Code Intelligence）工具，其核心能力是将代码仓库索引为知识图谱（Knowledge Graph），并通过 MCP（Model Context Protocol）或 CLI 对外提供查询能力，使 AI 智能体能够理解代码库中的依赖关系、调用链以及各类结构化关联信息。项目提供 CLI 与 MCP 两种主要使用方式，并支持多种 AI 开发工具集成。
项目通过一次分析（Analyze）过程完成代码仓库索引，同时自动安装 Agent Skills、注册 Claude Code Hooks，并生成 AGENTS.md 与 CLAUDE.md 等上下文文件，从而为 AI 智能体提供更完整的代码仓库上下文。GitNexus 同时提供 MCP Server、本地 HTTP Server、多仓库管理、Wiki 生成以及 Repository Group 等能力，用于支持复杂项目及多仓库场景。
GitHub 项目介绍还指出，GitNexus 的目标是帮助 AI 工具获得完整的代码库感知能力，使其能够基于预先构建好的依赖关系、调用链和知识图谱进行检索与分析，而不是仅依赖源码搜索。项目支持 Cursor、Claude Code、Codex、Windsurf、OpenCode、Antigravity 等 MCP 兼容工具。
Github地址：GitHub - abhigyanpatwari/GitNexus: GitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration · GitHub
1、特点
特点 | 详细说明 |
知识图谱索引 | 将代码仓库构建为可查询的知识图谱，包含依赖关系、调用链及代码关联信息。 |
CLI 与 MCP 支持 | 提供 CLI 工具进行索引，同时提供 MCP Server，供 AI Agent 查询代码库。 |
一键分析 | gitnexus analyze 可完成代码索引、安装 Agent Skills、注册 Claude Code Hooks，并生成上下文文件。 |
多编辑器集成 | 支持 Claude Code、Cursor、Codex、Windsurf、OpenCode、Antigravity 等编辑器或 AI 工具。 |
丰富 CLI 命令 | 提供 setup、analyze、serve、mcp、status、clean、wiki、publish、group 等命令。 |
MCP 工具集 | 提供 query、context、impact、detect_changes、rename、cypher 等 MCP 工具，以及 Repository Group 相关工具。 |
Repository Group | 支持创建仓库组、同步跨仓库契约、跨仓库查询执行流程及状态检查。 |
自动生成技能 | 可根据检测出的功能模块自动生成 Repo 专属 Skill 文件，为 AI Agent 提供模块级上下文。 |
Wiki 生成功能 | 可根据知识图谱自动生成仓库 Wiki，并支持指定模型及 API 地址。 |
GitNexus的安装和使用方法
1、安装
GitHub README 推荐使用 CLI + MCP 方式进行使用。
步骤一：进入需要分析的代码仓库根目录
步骤二：执行仓库分析命令：
npx gitnexus analyze该命令会完成以下操作：
对代码仓库建立索引；
安装 Agent Skills；
注册 Claude Code Hooks；
自动生成 AGENTS.md 与 CLAUDE.md。
步骤三：配置 MCP。
首次配置可执行：
npx gitnexus setupREADME 说明该命令能够自动检测编辑器并写入对应的全局 MCP 配置，仅需执行一次。
2、使用方法
完成安装后，可根据 README 使用以下主要命令：
（1）索引代码仓库
gitnexus analyze 或指定仓库路径： gitnexus analyze [path]还支持：--force、--repair-fts、--skills、--skip-embeddings、--embeddings、--verbose、--workers、--worker-timeout、--skip-git、--skip-agents-md 等参数。
（2）启动 MCP 服务
gitnexus mcp启动标准输入输出（stdio）方式的 MCP Server，为所有已索引仓库提供服务。
（3）启动本地 HTTP 服务
gitnexus serve启动本地 HTTP Server，用于 Web UI 连接。
（4）查看仓库状态
gitnexus status查看当前仓库索引状态。
（5）管理索引
查看已索引仓库： gitnexus list 删除当前仓库索引： gitnexus clean 删除全部索引： gitnexus clean --all --force（6）生成 Wiki
gitnexus wiki 也可指定模型或 API 地址： gitnexus wiki --model <model> gitnexus wiki --base-url <url>（7）Repository Group 管理
GitNexus 提供如下命令管理多仓库：
gitnexus group create gitnexus group add gitnexus group remove gitnexus group list gitnexus group sync gitnexus group contracts gitnexus group query gitnexus group status用于仓库组创建、同步、查询和状态管理。
GitNexus的案例应用
案例一：构建代码仓库知识图谱
在目标代码仓库根目录执行：
npx gitnexus analyze根据 README，该命令会建立代码仓库索引，同时安装 Agent Skills、注册 Claude Code Hooks，并生成 AGENTS.md 与 CLAUDE.md，为 AI Agent 提供完整的代码仓库上下文。
案例二：为 AI 编辑器配置 MCP
首次安装后执行：
gitnexus setupREADME 说明该命令能够自动识别支持的编辑器，并写入对应的全局 MCP 配置，完成一次配置后即可供支持 MCP 的编辑器使用。
案例三：启动 MCP 服务供 AI Agent 查询
执行：
gitnexus mcp启动 MCP Server，使已建立索引的仓库能够通过 MCP 工具进行访问。README 中列出的 MCP 工具包括 query、context、impact、detect_changes、rename、cypher 等，可用于查询代码、查看上下文、影响分析、变更检测及图查询等操作。
案例四：生成仓库 Wiki
执行：
gitnexus wikiGitHub README 表明，该命令可根据知识图谱生成仓库 Wiki，并支持通过 --model 指定模型、通过 --base-url 指定 API 地址，以满足不同生成需求。
案例五：管理多仓库项目
对于多仓库场景，可使用 Repository Group 功能，例如：
gitnexus group create <name> gitnexus group add <group> <groupPath> <registryName> gitnexus group sync <name> gitnexus group query <name> <query>README 说明，该功能支持创建仓库组、同步跨仓库契约、查询跨仓库执行流程以及检查仓库组状态，适用于多仓库或 Monorepo 服务管理。