personal-repo-mcp

Un servidor MCP autohospedado y multirrepositorio para agentes de IA. Proporciona al agente un espacio de trabajo Git persistente en tu propio VPS, con acceso controlado de lectura/escritura a repositorios aprobados por el administrador y operaciones Git normales.

Versión 1.0.0 — MVP

Idea principal

El administrador controla a qué repositorios puede acceder el agente. El agente controla qué repositorios permitidos clona realmente.

Administrator
    |
    | mcp-config add repo jsilvanus/*
    v
repositories.json (allow-list)
    |
    v
MCP server
    |
    +-- clone_repository("jsilvanus/project")
    |
    v
persistent workspace

Related MCP server: GitLab MR MCP

Recursos de ayuda de MCP

El servidor proporciona documentación operativa modular y nativa de MCP. Comienza con:

mcp://help/index

Los temas específicos están disponibles en:

mcp://help/repositories
mcp://help/files
mcp://help/git
mcp://help/chain-command
mcp://help/resources

Los recursos de ayuda están intencionadamente separados de tools/list: la lista de herramientas MCP sigue siendo la superficie de API autoritativa, mientras que los recursos de ayuda proporcionan orientación de flujo de trabajo con divulgación progresiva para los agentes.

Características

• Espacios de trabajo multirrepositorio persistentes

• Lista de repositorios permitidos controlada por el administrador

• Autenticación con PAT de GitHub para operaciones Git

• Transporte HTTP con streaming

• Lecturas de archivos, lecturas por rango de líneas, escrituras, ediciones de líneas, búsqueda y parches

• Estado de Git, diff, historial, ramas, fetch/pull/push, merge/rebase y gestión de conflictos

• chain_command de un solo repositorio para componer operaciones

• Recursos MCP para el sistema, el repositorio, Git y el estado de archivos individuales

• Suscripciones a recursos y notificaciones de cambios

• Limpieza de secretos de la salida de MCP

• Protecciones de submódulos Git

• Despliegue con Docker

Despliegue

Configura el host con mcp-config y luego inicia el despliegue único de Docker:

mcp-config pat
mcp-config add repo jsilvanus/*
docker compose up -d --build

mcp-config add repo solo modifica la lista de repositorios permitidos del administrador. No clona repositorios. El agente clona un repositorio permitido a través de MCP cuando es necesario.

Consulta la documentación de despliegue en docs/ para obtener detalles sobre almacenamiento persistente, credenciales, HTTPS y configuración.

Licencia

EUPL-1.2