Show HN: Forensic-deepdive——AIエージェントのためのコード知識グラフとMCPサーバー
Forensic-deepdiveは、任意のコードベース(9言語対応)に対して永続的なコード知識グラフを構築し、AIコーディングエージェント向けのMCPサーバーインターフェースを提供するオープンソースツールです。5つの人間が読めるMarkdown文書と10の統合ファイルを生成し、LLMやネットワークなしで完全にオフラインで動作します。
Forensic-deepdiveは、AIコーディングエージェント向けに設計されたコード知識グラフおよびMCP(Model Context Protocol)サーバーツールです。任意のコードベースを深く分析し、ファイル、シンボル、モジュール、コミット、作者、エンドポイント、データベーステーブルなどのノードと、定義、メンバー、インポート、呼び出し、拡張、実装などの関係エッジで結ばれた永続的なグラフを構築します。各エッジには信頼度タグ(EXTRACTED、INFERRED、AMBIGUOUS)が付与され、透明性が確保されています。特に、単一のエンドポイントノードが5つのクロスバウンダリプロトコル(HTTP、MCPツール、レジストリディスパッチ、gRPC、メッセージング/AMQP)を統合し、フロントエンドの呼び出しがバックエンドハンドラまで一貫して解決されます。
このツールは、impact(影響範囲分析)、context(コンテキスト照会)、archaeology(Git履歴調査)、flow(データフロー分析)、query(グラフ問い合わせ)、trace(クロススタックトレース)など9つの複合MCPツールを提供し、Claude Code、Cursor、Codex、Continue、Cline、WindsurfなどMCP対応のエージェントが利用できます。分析後、/docs/codebase/ ディレクトリに5つの永続的Markdown文書(MAP.md:コード構造マップ、HOTPATHS.md:依存関係のホットスポット(信頼度混合列付き)、ARCHAEOLOGY.md:コードの進化履歴、MENTAL_MODEL.md:新規メンバー向けガイド、AGENT_BRIEF.md:AIエージェント向けルール要約)を生成します。さらに、ターゲットリポジトリにエディタルールファイルやClaudeスキルを含む10の統合ファイルを注入しますが、既存ファイルは上書きしません。
Forensic-deepdiveは、エージェントが検証済みの学習内容を記録・呼び出すためのインサイトレイヤーも備えており、ローカルJSONファイルまたはオプションのグラフデータベースバックエンドをサポートします。すべての分析は静的コードとGit履歴に基づいており、LLMやネットワーク接続を必要とせず、完全にオフラインで動作します。現在のバージョンはv0.8.0で、PyPIから uv tool install forensic-deepdive でインストールできます。このツールはApache Superset、wagtail、spring-petclinicなど複数の実リポジトリでテストされていますが、作者は正直に、現時点では補助的な分析ツールであり、エージェントが実際の問題を解決する速度を測定可能な形で向上させることはまだ証明されていないと述べており、その評価は将来のバージョンに委ねられています。類似ツールと比較すると、Forensic-deepdiveはApache-2.0ライセンスであるのに対し、主な競合であるGitNexusはPolyForm Noncommercialライセンスを採用しており、商用利用が制限されています。