Git File Forensics

Git File Forensics MCP

Uma ferramenta MCP para perícia forense profunda em nível de arquivo no git, que ajuda a obter insights detalhados sobre históricos de arquivos, alterações e padrões, com foco na análise individual de arquivos em vez de operações em todo o repositório.

Instalação

1. Clone e compile o servidor:

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

2. Adicione às suas configurações do 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": []
    }
  }
}

Ferramentas Disponíveis

1. track_file_versions

Rastreia o histórico completo de versões de um arquivo específico, incluindo renomeações e movimentações.

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

2. analyze_file_diff

Analisa alterações específicas entre quaisquer duas versões de um arquivo.

{
  "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

Analisa o contexto mais amplo das alterações de arquivos em um commit específico.

{
  "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

Analisa alterações semânticas e padrões no histórico de arquivos.

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

Formato de Saída

Todas as ferramentas geram arquivos JSON contendo:

• Resultados detalhados da análise
• Estatísticas resumidas
• Padrões de alteração e relacionamentos
• Avaliações de risco (quando aplicável)

Requisitos

• Node.js
• Git (deve estar instalado e acessível)
• MCP SDK

Licença

Este projeto é licenciado sob a Apache License, Versão 2.0 — consulte o arquivo LICENSE.txt para obter detalhes.

Copyright davidorex.ai. Licenciado sob a Apache License, Versão 2.0; você não pode usar este projeto exceto em conformidade com a Licença. Você pode obter uma cópia da Licença em http://www.apache.org/licenses/LICENSE-2.0