Git Forensics MCP

Git Forensics MCP

Git リポジトリの詳細な調査と分析に特化した Model Context Protocol（MCP）サーバーです。このフォレンジックツールは、リポジトリの履歴、ブランチ間の関係、開発パターンについて詳しい情報を提供します。一般的な GitHub または git 操作ではなく、Git リポジトリの分析のみに焦点を当てています。

機能

このサーバーは、次の 4 つの主要な分析ツールを提供します。

1. ブランチ概要（get_branch_overview）

   • ブランチの状態と関係について、高レベルの概要を提供します
   • 最新のコミット、コミット数、マージベースを分析します
   • ブランチの活動に関する統計的な概要を生成します

2. 期間分析（analyze_time_period）

   • 特定の期間における詳細な開発活動を分析します
   • コミットを分類します（feature、fix、refactor、docs、other）
   • コミットパターンを含む活動概要を提供します

3. ファイル変更分析（analyze_file_changes）

   • ブランチをまたいで特定のファイルへの変更を追跡します
   • 潜在的な競合箇所を特定します
   • ファイル変更のリスク評価を提供します
   • リスクレベルに基づく推奨レビュー順を生成します

4. マージの推奨事項（get_merge_recommendations）

   • 最適なマージ戦略を判断します
   • 競合リスクを評価します
   • コードのホットスポットを特定します
   • 段階的なマージ手順を提供します

入力パラメーター

各ツールには、次のパラメーターが必要です。

• repoPath：Git リポジトリのパス
• branches：分析対象のブランチ名の配列
• outputPath：分析結果の出力先パス
• ツール固有の追加パラメーター：
  • timeRange：期間分析の開始日と終了日
  • files：ファイル変更分析の対象となるファイルパスの配列

出力形式

すべてのツールは、次の内容を含む JSON ファイルを出力します。

• 詳細な分析結果
• 概要統計
• リスク評価（該当する場合）
• 分析に基づく推奨事項

技術詳細

• TypeScript で構築
• サーバーの実装に MCP SDK を使用
• 子プロセスを通じて git コマンドを実行
• エラー処理と検証を提供
• stdio トランスポートで実行

依存関係

• @modelcontextprotocol/sdk
• Node.js
• Git（インストールされ、アクセス可能である必要があります）

使用方法

このサーバーは MCP サービスとして実行され、MCP 対応の任意のクライアントと統合できます。すべての分析結果は、指定された出力ファイルに JSON 形式で書き込まれます。

貢献とライセンス

このプロジェクトは Apache License, Version 2.0 のもとでライセンスされています。詳細については、LICENSE.txt ファイルをご覧ください。

コラボレーション歓迎

フォークや貢献を歓迎します。

すべての貢献は Apache License 2.0 のもとで提供されます。この寛容なライセンスでは、次のことが認められています。

• コードを商用利用する
• コードを変更して配布する
• 派生物を作成する
• 他のプロジェクトに含める

Copyright 2025. Apache License, Version 2.0 のもとでライセンスされています。このライセンスを遵守しない限り、このプロジェクトを使用することはできません。ライセンスのコピーは http://www.apache.org/licenses/LICENSE-2.0 から入手できます。