コードベースをインデックス化し、コーディングエージェントが意味でコードを検索できる、ASTベースのセマンティックコード検索CLIおよびMCPサーバー。
Jakedismo/codegraph-rust
コードベースのセマンティックなナレッジグラフを構築し、MCP経由でコーディングエージェントにエージェント型のコード解析ツールを提供するRust製ツール。
- スター
- 913
- フォーク
- 98
- 未解決の Issue
- 17
- 最終コミット
- 26 日前
これは何?
CodeGraphは、AST解析、任意のLanguage Serverによるシンボル解決、モジュールのリンク、埋め込みを組み合わせ、プロジェクトをノードとエッジからなるナレッジグラフにインデックス化します。グラフは各プロジェクトの`.codegraph`ディレクトリにある組み込みSurrealDBデータベースに保存されるため、別途データベースサーバーを用意する必要はありません。
Claude Code、Cursor、CodexなどのAIコーディングアシスタント向けに設計されています。4つの統合されたエージェント型ツール(context、impact、architecture、quality)がグラフ上で推論エージェントを実行し、検索結果の生リストではなく、ファイルパス、行番号、範囲を制限したコード断片を添えた回答を返します。インデックス作成はfast、balanced、fullの段階に分かれており、グラフの詳細度と速度・ストレージ使用量のバランスを選べます。
検索では、ベクトル類似度と語彙マッチングを組み合わせ、任意で再ランキングも行います。また、実行ごとにモデルへ渡すツール出力の量を制限し、Ollama、LM Studio、Jina、OpenAI、Anthropicなど複数の埋め込み・LLMプロバイダーに対応しています。
主な機能
- 01コードのノード、エッジ、モジュール、データフローの関係からナレッジグラフを構築します。
- 02context、変更の影響、アーキテクチャ、品質分析を行う4つのエージェント型MCPツールを提供します。
- 03任意のLSP解決に対応し、fast、balanced、fullのインデックス作成段階を選べます。
- 04プロジェクトごとに組み込みSurrealDBへデータを保存するため、別途サーバーは不要です。
- 05ベクトル検索と語彙検索を組み合わせ、任意で再ランキングを行います。
- 06.gitignoreを尊重し、インデックス作成時に一般的な秘密情報ファイルのパターンを除外します。
ユースケース
- 大規模なコードベースをリファクタリングする前に、Claude CodeやCursorへプロジェクト全体のコンテキストを提供する。
- 関数、型、モジュールを変更した場合に、どこへ影響が及ぶかを見積もる。
- なじみのないRustプロジェクトのアーキテクチャ概要を把握したり、複雑性の高い箇所を見つけたりする。
- ローカルまたはセルフホストの埋め込みモデルを実行し、ソースコードを手元のマシンから外に出さない。
クイックスタート
- 1
Installation Guide(docs/INSTALLATION_GUIDE.md)に従ってCodeGraphをインストールする
- 2
balanced tierでプロジェクトをインデックス化する
codegraph index /path/to/project --index-tier balanced - 3
コマンドラインから質問する
codegraph agent context "your question"
使う前に知っておきたいこと
- balanced tierとfull tierでインデックス化するには、rust-analyzer、node、goplsなどの外部言語サーバーをインストールする必要があります。
- インデックス化には多くの設定オプションと環境変数があるため、セットアップにはある程度の手間がかかります。
収録されている特集
トピック
よくある質問
- codegraph-rust とは?
- コードベースのセマンティックなナレッジグラフを構築し、MCP経由でコーディングエージェントにエージェント型のコード解析ツールを提供するRust製ツール。 CodeGraphは、AST解析、任意のLanguage Serverによるシンボル解決、モジュールのリンク、埋め込みを組み合わせ、プロジェクトをノードとエッジからなるナレッジグラフにインデックス化します。グラフは各プロジェクトの`.codegraph`ディレクトリにある組み込みSurrealDBデータベースに保存されるため、別途データベースサーバーを用意する必要はありません。
- codegraph-rust は無料で使えますか?ライセンスは?
- codegraph-rust にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
- codegraph-rust は今もメンテナンスされていますか?
- 活発にメンテナンス中。codegraph-rust の最終コミットは 2026年10月12日 です。
- codegraph-rust は何に使えますか?
- 大規模なコードベースをリファクタリングする前に、Claude CodeやCursorへプロジェクト全体のコンテキストを提供する。 関数、型、モジュールを変更した場合に、どこへ影響が及ぶかを見積もる。 なじみのないRustプロジェクトのアーキテクチャ概要を把握したり、複雑性の高い箇所を見つけたりする。 ローカルまたはセルフホストの埋め込みモデルを実行し、ソースコードを手元のマシンから外に出さない。
- codegraph-rust のインストール方法は?
- Installation Guide(docs/INSTALLATION_GUIDE.md)に従ってCodeGraphをインストールする balanced tierでプロジェクトをインデックス化する: codegraph index /path/to/project --index-tier balanced コマンドラインから質問する: codegraph agent context "your question"
- codegraph-rust はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/Jakedismo/codegraph-rust
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
コードベース、Issue、チームの知識をインデックス化するCLI主導のコンテキストグラフ。AIコーディングエージェントにプロジェクト固有の背景情報を提供します。
ローカルのOllamaまたはクラウドで動作し、ナレッジグラフを使って引用付きのマルチホップ質問応答を行う、オープンソースのGraphRAG・エージェントフレームワーク。
AIアプリ向けのオープンソース埋め込みデータベース。文書とベクトルを保存し、セマンティック検索、ハイブリッド検索、全文検索を実現します。
誰の記憶か、情報源、いつ有効だったか、誰が読めるかを記録する、AI向けローカルメモリストア。
コードベースやドキュメントなどから、AIコーディングアシスタント向けの知識グラフをローカルで構築