GitPilot MCP

Servidor MCP ligero para ejecutar flujos de Git desde asistentes de IA (como Cline, Cursor o clientes compatibles con MCP), usando herramientas simples y prácticas.

GitPilot MCP te permite conectar tu asistente con tu repositorio local para consultar estado, preparar cambios, hacer commits y obtener contexto del proyecto de forma rápida.

Por que este proyecto es util

• Reduce pasos manuales en tareas repetitivas de Git.
• Expone operaciones comunes como herramientas MCP reutilizables.
• Facilita que un asistente entienda el estado actual del repo antes de proponer cambios.
• Es pequeño, claro y facil de extender con nuevas herramientas.

Que incluye

Actualmente expone estas herramientas:

• git_status: devuelve la salida de git status.
• git_add(files): agrega archivos al staging (git add). Si no se envia lista, intenta agregar todo.
• git_commit(message): crea commit con mensaje.
• get_context: devuelve git diff, git diff --staged y estructura del repo con tree.

Stack

• Python 3.12+
• FastMCP
• Git CLI

Requisitos

• Python >=3.12
• Git instalado y disponible en PATH
• Recomendado: comando tree instalado (usado por get_context)

Instalacion

1. Clonar el repositorio

git clone <TU_REPO_URL>
cd git-mcp-server

2. Instalar dependencias

Con uv (recomendado):

uv sync

O con pip:

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install fastmcp

Ejecutar el servidor

python main.py

Servidor por defecto:

• Host: 127.0.0.1
• Puerto: 8000
• Endpoint MCP: http://127.0.0.1:8000/mcp

Configuracion MCP (ejemplo VS Code)

.vscode/mcp.json

{
  "servers": {
    "my-git-mcp-server": {
      "url": "http://127.0.0.1:8000/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

Flujo de uso sugerido

1. El asistente llama git_status para entender el estado.
2. Usa get_context para revisar diffs y estructura.
3. Prepara cambios con git_add.
4. Cierra con git_commit("mensaje").

Ejemplos de prompts utiles

• "Revisa el estado del repo y dime que archivos cambiaron."
• "Agrega todos los archivos y realiza un commit con un mensaje convencional."
• "Muestrame el contexto actual del repo para planear el siguiente cambio."

Limitaciones actuales

• No valida errores en profundidad en cada comando.
• No incluye politicas de seguridad por rama/entorno.
• git_add con * depende del comportamiento de shell/CLI; puede mejorarse para robustez total.

Roadmap recomendado

• Manejo robusto de errores y codigos de salida.
• Herramientas extra: git_log, git_checkout, git_branch, git_push.
• Configuracion por variables de entorno (host, puerto, repo target).
• Tests automaticos para cada herramienta MCP.

Contribuciones

PRs y mejoras son bienvenidas. Si propones una nueva herramienta, idealmente incluye:

• Caso de uso claro
• Ejemplo de prompt
• Validaciones de seguridad
• Pruebas

Licencia

Puedes publicar este repo con licencia MIT para facilitar adopcion. Si aun no definiste licencia, agrega un archivo LICENSE antes de hacerlo publico.

Si prefieres otro naming de marca, alternativas recomendadas:

• GitCopilot MCP
• RepoPilot MCP
• GitOps MCP Toolkit