DPR Git 기반 MCP 협업 서버

로컬 Git 저장소 위에서 안전한 다중 에이전트, 인간 개입(human-in-the-loop) 협업 인터페이스를 제공하는 독립형 Model Context Protocol 서버입니다.

Git은 파일, 커밋, 브랜치, diff, 병합 기록의 진실 공급원(source of truth)으로 남습니다. 이 서버는 그 위에 협업 제어 평면을 추가합니다: 신원, 권한 부여, 격리된 작업 공간, 변경 요청(Change Requests), 리뷰, 승인 정책, 충돌 워크플로, 롤백, 출처 추적(provenance).

이것은 Phase 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

서버는 stdio를 통해 MCP를 사용합니다. 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은 결코 재발명되지 않습니다: 브랜치, 커밋, diff, 병합은 모두 단일 GitRepository 추상화(src/dpr_mcp/git/repository.py)를 통해 실제 git CLI에 위임됩니다. Git이 모델링하지 않는 협업 상태(변경 요청, 리뷰, 승인, 작업 공간, 정책)는 작은 SQLite 데이터베이스(src/dpr_mcp/persistence/)에 저장됩니다.

보안

파일 접근은 구성된 프로젝트 루트로 샌드박싱됩니다: 경로 순회(path traversal), 절대 경로, 심볼릭 링크 탈출이 거부됩니다(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

Phase 2

Phase 2(여기서는 구현되지 않음)는 기존 DPR 다중 에이전트 오케스트레이터(https://github.com/Skanda-P-R/Multi-Agent-Reasoning)를 이 서버의 MCP 클라이언트로 만들 것입니다. 이를 통해 DPR의 내부 에이전트가 정확히 이 인터페이스를 통해 프로젝트 아티팩트를 검사, 생성, 수정, 리뷰하고 협업적으로 통합할 수 있으며, Git이 여전히 버전 관리의 진실 공급원을 유지하고 DPR이 추론/오케스트레이션을 담당하게 됩니다.