Cross Repo Ops MCP

リポジトリに依存しないMCP（Model Context Protocol）機能レイヤー。制御されたローカルリポジトリ操作を提供します。

機能概要

Cross Repo Ops MCPは、セキュリティ強化されたstdio JSON-RPCサーバーを提供し、ローカルgitリポジトリに対する境界付き・ポリシー制御の操作を公開します。

• 読み取り: ツリー一覧、ripgrep検索、境界付きファイル読み取り、git status/diff

• 書き込み: コンテキスト検証付きパッチ（作成・変更対応、書き込み可能なリポジトリのみ）

• タスク: 承認済みの名前付きタスク実行（許可リストのみ、任意のシェルは不可）

• Git: ブランチ一覧・作成・切り替え、コミット（明示的なファイルのみ）、プッシュ（originのみ、プッシュ可能なリポジトリのみ）

Related MCP server: void-bridge

アーキテクチャ

Cross Repo Ops MCPは、制御されたローカルリポジトリ操作のためのリポジトリ中立な機能レイヤーです。XcodeIDEappプロジェクトの隣に配置することを想定しており、IDEダッシュボードのスキャフォールディングパターンからアイデアを借用していますが、汎用的であり、特定のIDEやプロジェクト構造に依存しません。

Cross Repo Ops MCP = controlled local repository actions (read, patch, git, tasks)

サーバーはポリシー駆動です。リポジトリ、機能、除外パス、承認済みタスクはすべてJSON設定で宣言されます。コアにはプロジェクト固有のロジックはハードコードされていません。

モジュール

セキュリティモデル

• リポジトリ許可リスト: ポリシーに明示的にリストされたリポジトリのみアクセス可能。

• 機能フラグ: writable と pushable はリポジトリごとに設定され、デフォルトは false。

• パス包含: すべてのパスは解決され、リポジトリルートに対してチェックされます。トラバーサル（..）、絶対パス、シンボリックリンクは拒否されます。

• 機密ファイル除外: .env、*.pem、APIキー、トークン、資格情報、バイナリファイルは読み取り・書き込みからブロックされます。

• パッチ安全性: old_text は正確に一致する必要があります。複数の一致がある場合は context で曖昧さを解消します。create=true は既存ファイルの上書きを拒否します。

• タスク許可リスト: タスクはユーザー入力ではなく、サーバー側の許可リストから名前で解決されます。任意のシェルコマンドはありません。

• Git安全性: 一括ステージング（git add -A）は拒否されます。コミットは明示的にリストされたファイルに限定されます。機密ファイルはコミットできません。ブランチ名はインジェクションに対して検証されます。プッシュはプッシュ可能なリポジトリの origin に限定されます。

• 出力制限: すべての操作には設定可能な出力上限があります（読み取り文字数、検索結果、ツリーエントリ、diff文字数、タスク出力）。

インストール

# No external dependencies required — Python 3.10+ standard library only.
cd cross-repo-ops
pip install -e .  # optional, for package install

使用方法

MCPサーバーの実行

python3 -m cross_repo_ops

サーバーはstdin/stdoutでJSON-RPC 2.0メッセージを待ち受けます。

カスタムポリシー

CROSS_REPO_OPS_CONFIG=/path/to/policy.json python3 -m cross_repo_ops

ポリシーファイル形式

{
  "repos": {
    "myrepo": {
      "root": "/path/to/repo",
      "writable": true,
      "pushable": false
    }
  },
  "tasks": {
    "myrepo": {
      "build": {
        "command": ["xcodebuild", "-scheme", "MyApp", "build"],
        "cwd": "{root}",
        "timeout": 180
      },
      "test": {
        "command": ["xcodebuild", "test", "-scheme", "MyApp"],
        "cwd": "{root}",
        "timeout": 300
      }
    }
  }
}

MCPツール

テスト

python3 -m unittest tests.test_security tests.test_adversarial -v

32のテストをカバー:

• 許可された読み取りとブロックされた読み取り

• パストラバーサル、絶対パス、シンボリックリンクエスケープの拒否

• 機密ファイルの読み取り/書き込み/コミットのブロック

• 書き込み可能 vs 読み取り専用リポジトリの強制

• 正しい/古いコンテキストでのパッチ

• 除外ファイルを対象としたパッチ

• 名前付きタスク許可リスト（成功、不明な名前、シェルインジェクション試行）

• タスクのタイムアウトと出力切り詰め

• git status/diff

• ブランチ名インジェクションの保護

• コミット保護（空メッセージ、機密ファイル、一括ステージング、事前ステージング済みファイル）

• プッシュ可能でないリポジトリのプッシュ拒否

• サーバーの引数欠落処理

ライセンス

MIT