personal-repo-mcp

Ein selbst gehosteter Multi-Repository-MCP-Server für KI-Agenten. Er bietet einem Agenten einen persistenten Git-Arbeitsbereich auf Ihrem eigenen VPS, mit kontrolliertem Lese-/Schreibzugriff auf vom Administrator freigegebene Repositorys und normalen Git-Operationen.

Version 1.0.0 — MVP

Core idea

Der Administrator kontrolliert, auf welche Repositorys der Agent zugreifen darf. Der Agent kontrolliert, welche der freigegebenen Repositorys er tatsächlich klont.

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

MCP help resources

Der Server bietet modulare, MCP-native Betriebsdokumentation. Beginnen Sie mit:

mcp://help/index

Vertiefende Themen sind verfügbar unter:

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

Die Hilferessourcen sind bewusst von tools/list getrennt: Die MCP-Tool-Liste bleibt die maßgebliche API-Oberfläche, während die Hilferessourcen den Agenten eine Arbeitsablauf-Anleitung mit progressiver Offenlegung bieten.

Features

• Persistente Multi-Repository-Arbeitsbereiche

• Administratorgesteuerte Repository-Zulassungsliste

• GitHub-PAT-Authentifizierung für Git-Operationen

• Streamable-HTTP-Transport

• Dateilesevorgänge, Zeilenbereich-Lesevorgänge, Schreibvorgänge, Zeilenbearbeitungen, Suche und Patches

• Git-Status, Diff, Verlauf, Branches, Fetch/Pull/Push, Merge/Rebase und Konfliktbehandlung

• Einzelrepository-chain_command zum Zusammensetzen von Operationen

• MCP-Ressourcen für System-, Repository-, Git- und einzelne Dateizustände

• Ressourcen-Abonnements und Änderungsbenachrichtigungen

• Bereinigung von Geheimnissen aus der MCP-Ausgabe

• Git-Submodule-Schutzmaßnahmen

• Docker-Deployment

Deployment

Konfigurieren Sie den Host mit mcp-config und starten Sie dann das einzelne Docker-Deployment:

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

mcp-config add repo ändert nur die Administrator-Zulassungsliste. Es klont keine Repositorys. Der Agent klont ein freigegebenes Repository bei Bedarf über das MCP.

Details zu persistentem Speicher, Anmeldedaten, HTTPS und Konfiguration finden Sie in der Bereitstellungsdokumentation unter docs/.

License

EUPL-1.2