Skip to main content
Glama

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: Coding Tools 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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to perform full Git operations including branching, committing, pushing, stashing, rebasing, and more, with safety features and support for advanced workflows like Git Flow and LFS.
    33 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI clients to safely read, search, understand, and edit local project code and files, with Git inspection, code indexing, and controlled command execution within permissioned workspaces.
    3 npm
    6
    MIT