DPR Git-Backed MCP Collaboration Server

Автономный сервер Model Context Protocol, предоставляющий безопасный многогаентный интерфейс совместной работы с участием человека поверх локального Git-репозитория.

Git остаётся источником истины для файлов, коммитов, веток, диффов и истории слияний. Этот сервер добавляет над ним плоскость управления совместной работой: идентичность, авторизацию, изолированные рабочие пространства, запросы на изменения, ревью, политику утверждения, рабочий процесс разрешения конфликтов, откат и происхождение данных.

Это Фаза 1: автономный сервер, независимо используемый Claude Code, агентами VS Code или любым другим MCP-совместимым клиентом. Он не зависит от проекта многогаентного рассуждения DPR.

Быстрый старт

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

Сервер говорит на MCP через stdio. Направьте любой MCP-совместимый клиент (Claude Code, MCP Inspector, пользовательский клиент) на команду dpr-mcp.

Related MCP server: MCP Server

Пример рабочего процесса

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)

Смотрите examples/ для исполняемых скриптов, включая сценарий многогаентного конфликта (examples/multi_agent_demo.py, examples/conflict_demo.py).

Архитектура

Смотрите docs/architecture.md для полной картины. Вкратце:

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

Git никогда не изобретается заново: ветки, коммиты, диффы и слияния делегируются настоящему CLI git через единую абстракцию GitRepository (src/dpr_mcp/git/repository.py). Состояние совместной работы, которое Git не моделирует (запросы на изменения, ревью, утверждения, рабочие пространства, политики), хранится в небольшой базе данных SQLite (src/dpr_mcp/persistence/).

Безопасность

Доступ к файлам ограничен настроенным корнем проекта: обход пути, абсолютные пути и побеги через симлинки отклоняются (src/dpr_mcp/files/security.py). Чувствительные имена файлов (.env, .pem, .key, *credentials*) заблокированы по умолчанию. Смотрите docs/security.md и tests/security/ для полной модели угроз и тестов, которые её обеспечивают.

Разработка

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

Фаза 2

Фаза 2 (не реализована здесь) сделает существующий многогаентный оркестратор DPR (https://github.com/Skanda-P-R/Multi-Agent-Reasoning) MCP-клиентом этого сервера, чтобы внутренние агенты DPR могли просматривать, создавать, изменять, рецензировать и совместно интегрировать артефакты проекта через именно этот интерфейс, при этом Git остаётся источником истины для контроля версий, а DPR занимается рассуждением/оркестрацией.