DPR Git-Backed MCP Collaboration Server

Ein eigenständiger Model Context Protocol-Server, der eine sichere, Multi-Agent-, Human-in-the-Loop-Kollaborationsschnittstelle über ein lokales Git-Repository bereitstellt.

Git bleibt die Quelle der Wahrheit für Dateien, Commits, Branches, Diffs und Merge-Historie. Dieser Server fügt die Kollaborations-Kontrollebene darüber hinzu: Identität, Autorisierung, isolierte Arbeitsbereiche, Change Requests, Reviews, Genehmigungsrichtlinien, Konflikt-Workflow, Rollback und Herkunftsnachweis.

Dies ist Phase 1: ein eigenständiger Server, der unabhängig von Claude Code, VS-Code-Agenten oder jedem anderen MCP-kompatiblen Client verwendet werden kann. Er hat keine Abhängigkeit vom DPR-Multi-Agent-Reasoning-Projekt.

Schnellstart

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Optional: configure who this server instance acts as. Defaults to
# human:$USER driving agent:claude-code.
export DPR_PRINCIPAL_ID=charan
export DPR_ACTOR_ID=claude-code

# Optional: where projects/workspaces/the collaboration DB live.
export DPR_REPOSITORY_ROOT=./data/projects
export DPR_WORKSPACE_ROOT=./data/workspaces
export DPR_DATABASE_URL=sqlite:///./data/dpr_mcp.db

dpr-mcp

Der Server spricht MCP über stdio. Weisen Sie jeden MCP-kompatiblen Client (Claude Code, einen MCP Inspector, einen benutzerdefinierten Client) auf den Befehl dpr-mcp.

Related MCP server: MCP Server

Beispielablauf

create_project(project_id="demo", name="Demo Project")
create_workspace(project_id="demo")            -> workspace_id
create_file(workspace_id, "notes.md", "# Hi")
create_change(workspace_id, rationale="Add notes")   -> change_id
review_change(change_id, decision="APPROVED")  # as a human reviewer
merge_change(change_id)
get_provenance(change_id)

Siehe examples/ für ausführbare Skripte, einschließlich eines Multi-Agent- Konfliktszenarios (examples/multi_agent_demo.py, examples/conflict_demo.py).

Architektur

Siehe docs/architecture.md für das vollständige Bild. Kurz gesagt:

MCP Client
    |
    v
DPR MCP Server  (identity, authz, workspaces, changes, reviews, policy,
    |             conflicts, provenance)
    v
Git Repository  (commits, branches, diffs, merge)

Git wird nie neu erfunden: Branches, Commits, Diffs und Merges werden alle an die echte git-CLI über eine einzige GitRepository-Abstraktion delegiert (src/dpr_mcp/git/repository.py). Kollaborationszustand, den Git nicht modelliert (Change Requests, Reviews, Genehmigungen, Arbeitsbereiche, Richtlinien), lebt in einer kleinen SQLite-Datenbank (src/dpr_mcp/persistence/).

Sicherheit

Der Dateizugriff ist auf das konfigurierte Projektverzeichnis beschränkt: Pfad-Traversal, absolute Pfade und Symlink-Escapes werden abgelehnt (src/dpr_mcp/files/security.py). Sensible Dateinamen (.env, .pem, .key, *credentials*) sind standardmäßig blockiert. Siehe docs/security.md und tests/security/ für das vollständige Bedrohungsmodell und die Tests, die es durchsetzen.

Entwicklung

pytest                 # unit + integration + security + mcp tests
ruff check src tests
mypy src

Phase 2

Phase 2 (hier nicht implementiert) wird den bestehenden DPR-Multi-Agent- Orchestrator (https://github.com/Skanda-P-R/Multi-Agent-Reasoning) zu einem MCP- Client dieses Servers machen, sodass DPRs interne Agenten Projektartefakte durch genau diese Schnittstelle inspizieren, erstellen, modifizieren, überprüfen und gemeinsam integrieren können, wobei Git weiterhin die Versionskontroll-Grundwahrheit hält und DPR Reasoning/Orchestrierung übernimmt.