DPR Git-Backed MCP Collaboration Server

Un servidor independiente Model Context Protocol que proporciona una interfaz de colaboración segura, multiagente y con supervisión humana sobre un repositorio Git local.

Git sigue siendo la fuente de verdad para archivos, confirmaciones, ramas, diferencias e historial de fusiones. Este servidor añade el plano de control de colaboración por encima: identidad, autorización, espacios de trabajo aislados, solicitudes de cambio, revisiones, política de aprobación, flujo de conflictos, reversión y procedencia.

Esta es la Fase 1: un servidor independiente, utilizable por Claude Code, agentes de VS Code o cualquier otro cliente compatible con MCP. No tiene dependencia del proyecto de razonamiento multiagente DPR.

Inicio rápido

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

El servidor habla MCP sobre stdio. Apunte cualquier cliente compatible con MCP (Claude Code, un MCP Inspector, un cliente personalizado) al comando dpr-mcp.

Related MCP server: MCP Server

Flujo de ejemplo

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)

Consulte examples/ para ver scripts ejecutables, incluido un escenario de conflicto multiagente (examples/multi_agent_demo.py, examples/conflict_demo.py).

Arquitectura

Consulte docs/architecture.md para obtener una visión completa. En resumen:

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

Git nunca se reinventa: las ramas, confirmaciones, diferencias y fusiones se delegan todas en la CLI real de git mediante una única abstracción GitRepository (src/dpr_mcp/git/repository.py). El estado de colaboración que Git no modela (solicitudes de cambio, revisiones, aprobaciones, espacios de trabajo, políticas) reside en una pequeña base de datos SQLite (src/dpr_mcp/persistence/).

Seguridad

El acceso a archivos está aislado en la raíz del proyecto configurada: se rechazan el recorrido de rutas, las rutas absolutas y las fugas de enlaces simbólicos (src/dpr_mcp/files/security.py). Los nombres de archivo sensibles (.env, .pem, .key, *credentials*) están bloqueados por defecto. Consulte docs/security.md y tests/security/ para ver el modelo de amenazas completo y las pruebas que lo aplican.

Desarrollo

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

Fase 2

La Fase 2 (no implementada aquí) convertirá al orquestador multiagente DPR existente (https://github.com/Skanda-P-R/Multi-Agent-Reasoning) en un cliente MCP de este servidor, de modo que los agentes internos de DPR puedan inspeccionar, crear, modificar, revisar e integrar colaborativamente artefactos del proyecto a través de exactamente esta interfaz, con Git manteniendo la verdad de control de versiones y DPR manejando el razonamiento/orquestación.