git-context-mcp

Un servidor MCP que responde a la pregunta que todo desarrollador se hace: "¿por qué existe este código?"

git blame te dice quién escribió una línea. Esto te dice por qué.

Dada una línea o rango de líneas de un archivo, git-context-mcp rastrea el commit, encuentra la solicitud de extracción (pull request) que lo introdujo, lee la descripción del PR y muestra todos los issues de GitHub vinculados, todo de una vez, directamente dentro de Claude.

Demo

You: Why does line 87 of src/auth/session.ts exist?

Claude (using blame_context):
  Commit `a3f9c12` by Sarah Chen on 2024-08-14
  Message: "fix: rotate session tokens on privilege escalation"

  PR #441 — "Security: fix session fixation vulnerability"
  Merged: 2024-08-15  |  Labels: security, critical

  PR Description:
  > After the pen test in sprint 22, we found that session tokens
  > weren't being rotated when a user's role changed. This allows
  > a stolen low-priv token to be used after the account is promoted.

  Linked Issue #389 — "Session token not rotated on role change" (closed)
  > Reported by @contractor-red: "I was able to reuse a captured
  > token after my account was upgraded to admin..."

Se acabó el buscar en el registro de git, investigar en GitHub y cruzar referencias en los gestores de incidencias. Claude lo hace en un solo paso.

Related MCP server: Selvedge

Herramientas

Instalación

Opción 1 — npx (sin instalación)

claude mcp add git-context -- npx git-context-mcp

Opción 2 — instalación global

npm install -g git-context-mcp
claude mcp add git-context -- git-context-mcp

Opción 3 — configuración manual

Añadir a ~/.claude/claude_mcp_config.json:

{
  "mcpServers": {
    "git-context": {
      "command": "npx",
      "args": ["git-context-mcp"]
    }
  }
}

Luego reinicia Claude Code.

Requisitos

• Claude Code (o cualquier cliente compatible con MCP)

• git en el PATH

• CLI de gh (instalar) + gh auth login para búsquedas de PR/issues en GitHub

  • Funciona sin gh, simplemente omite el contexto de PR/issue

Ejemplos de uso

Una vez instalado, habla con Claude de forma natural en cualquier repositorio git:

"Why does line 42 of src/db/connection.ts exist?"
"What's the story behind commit d4a8f91?"
"Who owns the most of src/payments/stripe.ts?"
"When was the rate limiting added? Search commits for 'rate limit'"
"Show me the last 5 changes to src/api/auth.ts and why each was made"

Cómo funciona

1. blame_context ejecuta git blame -p en tus líneas para encontrar el/los hash(es) del commit

2. Para cada commit, llama a git show para obtener el mensaje completo y las estadísticas del diff

3. Consulta la API de GitHub (gh api /repos/:owner/:repo/commits/:hash/pulls) para encontrar el PR

4. Analiza las referencias #NNN y /issues/NNN del cuerpo del PR y obtiene cada issue

5. Todo se devuelve como markdown estructurado para que Claude pueda razonar sobre ello

No se almacenan tokens. No se envían datos a ningún lugar excepto a la propia API de GitHub (igual que la CLI de gh).

Contribuciones

Las PR son bienvenidas. Todo el servidor reside en src/index.ts.

git clone https://github.com/muhannad-hash/git-context-mcp
cd git-context-mcp
npm install
npm run dev   # watch mode

Licencia

MIT