Mooring — Servidor MCP de Git y GitHub

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

GitHub

Utilidad

Related MCP server: Git MCP Server

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

Licencia

MIT