Git Forensics MCP

GitフォレンジックMCP

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

特徴

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

1. ブランチの概要( get_branch_overview )
   • ブランチの状態と関係性の概要を提供します
   • 最後のコミット、コミット数、マージベースを分析します
   • 支店活動の統計要約を生成する
2. 期間分析( analyze_time_period )
   • 特定の期間における詳細な開発活動を分析します
   • コミットを分類する（機能、修正、リファクタリング、ドキュメント、その他）
   • コミットパターンを含むアクティビティサマリーを提供します
3. ファイル変更分析( analyze_file_changes )
   • ブランチ間で特定のファイルの変更を追跡します
   • 潜在的な紛争地域を特定する
   • ファイル変更のリスク評価を提供します
   • リスクレベルに基づいて推奨レビュー順序を生成します
4. マージの推奨事項( get_merge_recommendations )
   • 最適なマージ戦略を決定する
   • 紛争リスクを評価する
   • コードのホットスポットを特定する
   • ステップバイステップのマージガイダンスを提供します

入力パラメータ

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

• repoPath : Gitリポジトリへのパス
• branches : 分析するブランチ名の配列
• outputPath : 分析結果が書き込まれるパス
• 追加のツール固有のパラメータ:
  • timeRange : 期間分析の開始日と終了日
  • files : ファイル変更分析のためのファイルパスの配列

出力形式

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

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

技術的な詳細

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

依存関係

• @モデルコンテキストプロトコル/sdk
• Node.js
• Git (インストールされ、アクセス可能である必要があります)

使用法

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

貢献とライセンス

このプロジェクトは、Apache License バージョン 2.0 に基づいてライセンスされています。詳細については、 LICENSE.txtファイルを参照してください。

コラボレーション歓迎

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

すべての貢献はApache License 2.0に基づきます。この寛容なライセンスでは、以下のことが認められています。

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

Copyright 2025. Apache License, Version 2.0に基づきライセンスされています。本プロジェクトは、本ライセンスに準拠しない限り利用できません。本ライセンスのコピーは、 http://www.apache.org/licenses/LICENSE-2.0から入手できます。