Mooring — Servidor MCP de Git y GitHub

License: MIT

Líneas de amarre para tu código: operaciones de Git y GitHub para herramientas de IA.

Mooring es un servidor MCP que proporciona a los asistentes de IA acceso estructurado a repositorios Git locales y a la API de GitHub. Las operaciones locales utilizan GitPython (sin llamadas a subprocesos). Las operaciones de GitHub utilizan la biblioteca PyGithub con enmascaramiento de tokens y gestión de límites de tasa integrados.

Herramientas

Git local

Herramienta	Descripción	Parámetros clave
`repo_status`	Rama, adelante/atrás, recuento de stashes, archivos preparados/no preparados/no rastreados	`repo_path`
`repo_log`	Registro de commits con filtros opcionales	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	Diferencia unificada: árbol de trabajo, preparado o entre referencias	`repo_path`, `staged`, `from_ref`, `to_ref`
`repo_blame`	Git blame con rango de líneas opcional	`repo_path`, `file_path`, `start_line`, `end_line`
`repo_branches`	Todas las ramas con información de seguimiento, último commit, adelante/atrás	`repo_path`
`repo_stash`	Operaciones de stash: listar, enviar, extraer, aplicar	`repo_path`, `action`, `message`

GitHub

Herramienta	Descripción	Parámetros clave
`gh_pr_list`	Listar solicitudes de extracción (pull requests)	`repo`, `state`, `author`, `label`
`gh_pr_detail`	Detalle de PR con revisiones, comentarios y ejecuciones de comprobación	`repo`, `number`
`gh_pr_create`	Crear una solicitud de extracción	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	Listar, crear o actualizar issues	`repo`, `state`, `action`, `title`, `body`, `number`
`gh_actions`	Listar ejecuciones recientes de flujos de trabajo de GitHub Actions	`repo`, `workflow`, `status`

Utilidad

Herramienta	Descripción	Parámetros clave
`health`	Versión del servidor y comprobación de estado	(ninguno)

Instalación

# PyPI
pip install mooring-mcp

# Isolated install
pipx install mooring-mcp

Uso

Ejecuta el servidor directamente:

mooring

Claude Code

claude mcp add mooring -- mooring

Claude Desktop

Añádelo a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mooring": {
      "command": "mooring",
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token"
      }
    }
  }
}

La variable de entorno GITHUB_TOKEN es necesaria para todas las herramientas de GitHub (gh_*). Las herramientas de Git local funcionan sin ella.

Seguridad

Protección contra recorrido de rutas — las rutas de archivo se resuelven y validan contra la raíz del repositorio antes de cualquier operación
Detección de escape de enlaces simbólicos — los enlaces simbólicos que se resuelven fuera del repositorio son rechazados
Validación de referencias — las referencias de Git se verifican contra un patrón de caracteres seguro y se comprueba que existan antes de su uso
Enmascaramiento de tokens — los mensajes de error se limpian de patrones de tokens de GitHub (ghp_*, gho_*, github_pat_*) antes de ser devueltos
Gestión de límites de tasa — las respuestas 403 de GitHub se capturan y se muestran como mensajes claros en lugar de excepciones sin procesar

Desarrollo

git clone https://github.com/seayniclabs/mooring.git
cd mooring
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q