git-graph-mcp

Una herramienta de terminal para el gráfico de commits de Git con prioridad local, que además ofrece un servicio estándar MCP stdio. Permite seleccionar commits o rangos en la terminal y que clientes MCP como Claude Code, Codex, Cursor, etc., lean el mismo contexto de Git sujeto a presupuesto.

Qué puede hacer

• Ver el gráfico de commits, las ramas, los detalles de los commits y el estado del área de trabajo en la terminal;

• Guardar selecciones de commit, range y ref, y reutilizarlas entre CLI/TUI/MCP;

• Leer graph, status, context, search, diff, history y resources a través de MCP;

• Generar acciones de rama seguras y vistas previas de reset, sin ejecutar automáticamente reset/checkout/push;

• Usar doctor para comprobar Node.js, Git, el repositorio, la configuración de MCP y el handshake de stdio.

Related MCP server: org-as-code MCP Server

Inicio rápido

Requisitos: Git en PATH, soporte oficial para Node.js 22+.

npm ci
node .\bin\git-graph-mcp.js graph --plain --limit 8
node .\bin\git-graph-mcp.js doctor

TUI interactiva:

node .\bin\git-graph-mcp.js graph

Operaciones comunes:

node .\bin\git-graph-mcp.js status
node .\bin\git-graph-mcp.js search --limit 20
node .\bin\git-graph-mcp.js select commit <commit-oid>
node .\bin\git-graph-mcp.js selected
node .\bin\git-graph-mcp.js doctor --json

Cuando el repositorio de destino no sea el directorio actual, añade --repo <path> al comando.

Configuración de MCP

El .mcp.json en la raíz del repositorio usa stdio local:

{
  "mcpServers": {
    "git-graph": {
      "type": "stdio",
      "command": "node",
      "args": ["./bin/git-graph-mcp.js", "mcp"]
    }
  }
}

El servidor proporciona 12 herramientas acotadas y dos resources de solo lectura: git-graph://default/selection, git-graph://default/status. El stdout de MCP solo conserva mensajes de protocolo; la información de diagnóstico se escribe en stderr y no refleja rutas del repositorio, valores de configuración ni contenido de solicitudes.

Límites de seguridad

El flujo de trabajo predeterminado es de solo lectura. La creación de ramas exige una invocación explícita y no mueve ramas existentes; reset solo genera vistas previas, y git_revalidate_plan verifica la huella del estado del repositorio antes de la acción. El proyecto no inicia listeners de red, ni sube contenido del repositorio.

Desarrollo y publicación

npm run check
npm run test:package-install

Más información:

• Demo de cinco minutos

• Capacidades y evidencia de pruebas

• Guía de contribución

• Política de seguridad

• Lista de verificación de publicación