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から入手できます。