Git File Forensics

🚀 Gitファイル調査MCPツール

このツールは、gitファイルの階層を詳細に分析するための調査ツールです。ファイルの履歴、変更、パターンに関する詳細な洞察を得ることができ、対象は単一のファイルであり、リポジトリ全体ではありません。

🚀 クイックスタート

このセクションでは、Gitファイル調査MCPツールのクイックスタート方法を説明します。

📦 インストール

1. コードリポジトリのクローンとビルド

以下のコマンドを使用して、コードリポジトリをクローンし、ビルドします。

git clone [repository-url]
cd git-file-forensics
npm install
npm run build

2. MCP設定への追加

以下の設定をMCP設定（例：~/Library/Application Support/Code/User/globalStorage/david-dafu-dev.dafu/settings/cline_mcp_settings.json）に追加します。

{
  "mcpServers": {
    "git-file-forensics": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/git-file-forensics/build/index.js"],
      "alwaysAllow": []
    }
  }
}

💻 使用例

利用可能なツール

1. track_file_versions

特定のファイルの完全なバージョン履歴（名前の変更や移動を含む）を追跡します。

{
  "method": "tools/call",
  "params": {
    "name": "track_file_versions",
    "arguments": {
      "repoPath": "/path/to/repo", // リポジトリのパス
      "file": "path/to/file",     // ファイルのパス
      "outputPath": "output.json"  // 出力ファイルのパス
    }
  }
}

2. analyze_file_diff

2つのバージョン間の具体的な変更を分析します。

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_diff",
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "versions": {              // バージョン比較情報
        "from": "commit-hash-1", // 開始コミットのハッシュ値
        "to": "commit-hash-2"    // 終了コミットのハッシュ値
      },
      "outputPath": "output.json"
    }
  }
}

3. analyze_file_context

特定のコミットにおけるファイルの変更コンテキストを分析します。

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_context", 
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "commit": "commit-hash",   // コミットのハッシュ値
      "outputPath": "output.json"
    }
  }
}

4. analyze_file_semantics

ファイルの履歴における意味的な変更とパターンを分析します。

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_semantics",
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "outputPath": "output.json"
    }
  }
}

出力形式

すべてのツールはJSONファイルを出力し、以下の情報が含まれます。

• 詳細な分析結果
• 統計的な要約情報
• 変更パターンの記録
• リスク評価データ

🔧 技術詳細

システム要件

• Node.js：ツールを実行するために必要です。
• Git：バージョン管理ツールです。
• MCP SDK：必要な開発ライブラリです。

📄 ライセンス

このツールはApache License 2.0でライセンスされています。ソースコードと詳細情報は以下のリンクから入手できます。

[版权声明信息]

このツールは、開発者に強力なファイル履歴分析機能を提供し、コードの変更パターンを識別し理解するのに役立ちます。