project
GitNexus - 完全な依存関係グラフを構築するためのオープンソースの知識グラフエンジン。
GitNexusは、オープンソースのコード知識グラフエンジンであり、Tree-sitter解析を使用してコードリポジトリから完全な依存関係グラフを構築し、MCPプロトコルを使用してこれらのグラフをCursor、Claude Code、CodexなどのAIツールに公開します。
GitNexusとは何ですか?
GitNexusは、オープンソースのコード知識グラフエンジンであり、Tree-sitter解析を使用してコードリポジトリから完全な依存関係グラフを構築し、MCPプロトコルを使用してCursor、Claude Code、CodexなどのAIツールに構造化されたコンテキストを提供します。これらのツールは、呼び出しチェーン、クラスタ、リスクスコア、その他の関係を事前に計算できるため、AIは単一の呼び出しでコードリポジトリの全体像を把握でき、複数回のクエリを実行する必要がなくなります。
GitNexusの主な機能
- 知識グラフの構築コードリポジトリを解析し、ノード(関数、クラス、メソッド、インターフェース)とエッジ(呼び出し、継承、インポート、実装)からなるグラフを作成します。14種類の主要なプログラミング言語をサポートしています。
- 影響分析任意のシンボルを入力すると、多段階の依存関係の影響範囲が返され、信頼度とリスクレベルがマークされるため、コードを変更する前にどの呼び出し元がクラッシュするかを予測できます。
- 360°シンボルコンテキスト単一のシンボルを照会する場合、そのシンボルの上流呼び出し元、下流呼び出し先、実行フロー、およびファイル間参照も返されるため、AIのコンテキスト盲点が解消されます。
- 変化検出Gitの差分をナレッジグラフと比較することで、変更内容が影響を受けるシンボルやプロセスに自動的にマッピングされ、リスクレベルが評価されます。
- 複数のファイルの名前を変更するグラフの依存関係に基づいてファイル間の協調的な名前変更を実行し、信頼性の高いグラフ編集と信頼性の低いテキスト検索編集を区別します。
- ハイブリッド検索BM25 + セマンティックベクトル + RRF 融合検索は、実行フローごとにグループ化された結果を返し、コミュニティ全体にわたるクリティカルパスの表示を優先します。
- 暗号グラフ検索: コードベース上でCypherグラフクエリ言語を直接実行し、信頼性の高い呼び出し関係や特定のコミュニティ構造の取得をカスタマイズします。
- Wikiが自動生成知識グラフ構造に基づいて、LLMを呼び出してモジュールのドキュメントとアーキテクチャ概要を自動生成し、多言語出力に対応しています。
GitNexusの技術的原則
- 多段階インデックス作成パイプラインGitNexusは、コードベースを知識グラフに変換するために6段階のパイプラインを採用しています。最初の段階では、ファイルツリーを走査してディレクトリ構造のマッピングを確立します。2番目の段階では、ツリーシッターを使用してASTを解析し、関数、クラス、メソッド、インターフェースなどのシンボルノードを抽出します。3番目の段階では、ファイル間解析を実行して、インポート、呼び出し、継承の関係を解決し、コンストラクタ関数などを推論します。
self/this第4段階では、ライデンコミュニティ検出アルゴリズムを使用して関連するシンボルを機能モジュールにクラスタリングします。第5段階では、エントリポイントから実行プロセスを追跡して、ステップインデックス付きのプロセスチェーンを生成します。第6段階では、BM25転置インデックス、意味ベクトル、およびRRF再順序付けを統合したハイブリッド検索インデックスを構築します。 - グラフの保存と並行処理インデックスの結果はLadybugDBに保存され、CLIはネイティブバインディングを使用し、Web UIはWASMバージョンを使用します。データは完全にローカルに永続化されます。解析フェーズでは、ワーカー スレッド プールを使用して並行処理を行い、ブロック スケジューリングとタイムアウト ロールバック メカニズムによってスループットと安定性のバランスを取ります。大規模リポジトリは組み込みベクトル生成をサポートしており、メモリ オーバーフローを防ぐためにデフォルトの安全制限は 50,000 ノードです。
- 計算前関係性インテリジェンス従来のグラフRAGは、生のグラフエッジをLLMにフィードしてリアルタイムで探索を行うのに対し、GitNexusはインデックス作成フェーズでクラスタリング、コールチェーン追跡、リスク信頼度スコアリングを完了します。クエリ実行時には、MCPツールが構造化された結果を一度に返すため、AIは複数回のやり取りなしに、完全な360°シンボルコンテキスト、影響範囲、変更検出レポートを取得できます。
GitNexusの使い方
- CLI + MCPメソッド:
-
グローバルインストール:
npm install -g gitnexus -
リポジトリのルートディレクトリに移動して、:
npx gitnexus analyze -
ワンクリックでエディター設定:
npx gitnexus setup -
Claude Code/CursorなどのツールからMCPツールを直接呼び出す
-
- Web UIアプローチ:
-
アクセス
gitnexus.vercel.appGitHubリポジトリまたはZIPファイルをブラウザに直接ドラッグ&ドロップしてください。 -
またはローカルで実行
npx gitnexus@latest serveバックエンドは自動的に起動し、フロントエンドが接続されます。
-
- Dockerアプローチ:埋め込む
docker compose up -dバックエンド(ポート4747)とフロントエンド(ポート4173)を同時に起動してください。
GitNexusの主な利点
- 計算前関係性インテリジェンス従来のグラフRAGは、元のグラフのエッジをLLMにダンプして探索するだけですが、GitNexusはインデックス作成フェーズでクラスタリング、コールチェーンのトレース、リスクスコアリングを完了するため、AIは1回の呼び出しで完全な回答を得ることができます。
- ローカルゼロサーバーCLIはインターネット接続やコードのアップロードを必要とせず、完全にローカルで動作します。Web UIはブラウザ内でのみデータを処理し、ローカルマシンからデータが外部に送信されることはありません。
- 小型モデルに最適重い処理はツール層が担うため、モデル自体に高度な推論能力は必要ありません。小規模および中規模のモデルでも、大規模モデルと同等のアーキテクチャの明瞭さを実現できます。
- 複数のリポジトリに対するグローバル登録1台のMCPサーバーは、複数のインデックス付きリポジトリを同時に提供できます。
~/.gitnexus/registry.jsonグローバル管理が可能で、プロジェクトごとに設定する必要はありません。 - Deepinエディターとの統合Claude Codeは最も包括的なサポート(MCP + スキル + ツール使用前後のフック)を受けており、インデックスの有効期限切れを自動的に検出し、送信後に再インデックス作成を促します。
GitNexusプロジェクトのアドレス
- プロジェクト公式サイト:https://gitnexus.vercel.app/
- GitHubリポジトリ:https://github.com/abhigyanpatwari/GitNexus
GitNexusの競合製品比較
| 寸法 | GitNexus | DeepWiki |
|---|---|---|
| コア出力 | 構造化知識グラフ+クエリ可能なツール | 自然言語文書記述 |
| 関係性の表現 | 明示的なグラフのエッジ(呼び出し、継承、インポート) | テキストの説明に暗黙的に含まれている |
| AIの活用 | ツール呼び出しにより、完全なコンテキストが一度に返されます。 | 文章を読むには、構造を独自に推測する必要がある。 |
| モデルしきい値 | 小型モデルでも使用可能だが、重労働は専用工具で行う必要がある。 | 長文を理解するために大規模モデルに頼る |
| 典型的な行動 | 「UserServiceの依存関係の影響を照会する」 | UserServiceの機能説明をお読みください。 |
| エディター統合 | ネイティブMCP、Cursor/Claude/Codexをサポート | 一般的には、独立したプラットフォームまたはドキュメントサイト |
| プライバシー | 完全ローカル、アップロードなし | 通常はクラウド処理が必要です。 |
GitNexusの応用シナリオ
- 再建前評価コアサービスの戻り値を変更する前に、まず...
impactこのツールを使用すると、すべての依存関係と多層的なリスクを可視化できるため、単一の問題が広範囲にわたる影響を及ぼすことを防ぐことができます。 - コードに精通した新人知識グラフと自動生成されたWikiを通じて、馴染みのないコードベースのモジュール分割、実行フロー、主要なエントリポイントを迅速に理解できます。
- バグの根本原因追跡:使用
contextそしてquery呼び出しチェーンを遡って追跡することで、ファイル間を伝播する欠陥の経路を特定できる。 - PRインパクトレビュー提出前に実行
detect_changesこれは差分を影響を受けるシンボルとプロセスにマッピングし、リスクレポートを自動的に生成します。 - リポジトリ間マイクロサービスガバナンス:合格
groupこのコマンドは、複数のリポジトリからなるグループを作成し、サービス間の契約を抽出し、リポジトリ間の呼び出し関係を照合します。