mcp-git-tools

Herramientas de análisis de repositorios Git para agentes de IA, servidas a través de MCP (Model Context Protocol). Analiza repositorios locales usando comandos nativos de git — no se requiere API de GitHub.

Herramientas

Related MCP server: mcp-git

Requisitos previos

• Node.js >= 18

• Git instalado y disponible en PATH

Configuración

npm install
npm run build

Configuración del cliente

Añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

Detalles de las herramientas

git_log

Recuperar historial de commits reciente con filtros opcionales.

Parámetros:

• repoPath (obligatorio) — Ruta absoluta al repositorio Git

• count — Número de commits a devolver (por defecto: 20)

• author — Filtrar por nombre o correo del autor

• since / until — Filtros de rango de fechas

• path — Filtrar a commits que tocan un archivo o directorio específico

git_diff

Comparar dos referencias y obtener un resumen estructurado de los cambios.

Parámetros:

• repoPath (obligatorio) — Ruta absoluta al repositorio Git

• from — Referencia inicial (por defecto: HEAD~1)

• to — Referencia final (por defecto: HEAD)

• path — Limitar la diferencia a un archivo o directorio específico

• summaryOnly — Devolver solo estadísticas sin el texto completo de la diferencia

git_blame

Ver la autoría línea por línea de un archivo.

Parámetros:

• repoPath (obligatorio) — Ruta absoluta al repositorio Git

• filePath (obligatorio) — Ruta del archivo relativa a la raíz del repositorio

• startLine / endLine — Culpar a un rango de líneas específico

• ref — Culpar en un commit específico

git_stats

Obtener una visión general de alto nivel de la actividad del repositorio.

Parámetros:

• repoPath (obligatorio) — Ruta absoluta al repositorio Git

• topAuthors — Número de principales contribuyentes a listar (por defecto: 10)

• topFiles — Número de archivos más modificados a listar (por defecto: 10)

git_branch

Listar y analizar ramas.

Parámetros:

• repoPath (obligatorio) — Ruta absoluta al repositorio Git

• baseBranch — Rama contra la que comparar (por defecto: main o master)

• includeRemote — Incluir ramas de seguimiento remoto

• mergedOnly / unmergedOnly — Filtrar por estado de fusión

Licencia

MIT