DPR Git-Backed MCP Collaboration Server

スタンドアロンの Model Context Protocol サーバーで、 ローカル Git リポジトリ上に安全なマルチエージェント・ヒューマンインザループの コラボレーションインターフェースを提供します。

Git は、ファイル、コミット、ブランチ、差分、マージ履歴の真実のソースであり続けます。 このサーバーは、その上にコラボレーション制御プレーンを追加します: アイデンティティ、認可、分離されたワークスペース、変更リクエスト、レビュー、 承認ポリシー、競合ワークフロー、ロールバック、および来歴。

これは 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 は決して再発明されません: ブランチ、コミット、差分、マージはすべて、単一の GitRepository 抽象化 (src/dpr_mcp/git/repository.py) を介して実際の git CLI に委任されます。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 は推論/オーケストレーションを処理します。