Skip to main content
Glama
ShinonomeAya

git-graph-mcp

by ShinonomeAya

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.

Vista previa del terminal

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: worktree-map

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:

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    B
    maintenance
    MCP server that visualizes git branch genealogy and worktree locations within a repository, marking the current session position. Supports creating branches/worktrees, safe deletion/cleanup, and session navigation with fallback guidance.
    2
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    A local git MCP server. It exposes 12 git operations to an MCP client over stdio, allowing the client to inspect and work with a git repository on your machine, including status, diffs, log, branches, staging, and commits.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables people and AI agents to query local code repositories as graphs through stdio MCP tools for project listing, search, dependency tracing, impact analysis, bridge detection, node inspection, bounded code reading, and optional LSP definition/reference lookups.
    MIT