Cross Repo Ops MCP

제어된 로컬 저장소 작업을 위한 저장소 중립적 MCP(Model Context Protocol) 기능 계층입니다.

기능

Cross Repo Ops MCP는 로컬 git 저장소에 대한 제한적이고 정책 기반의 작업을 노출하는 보안 강화 stdio JSON-RPC 서버를 제공합니다:

• 읽기: 트리 목록, ripgrep 검색, 제한된 파일 읽기, git status/diff

• 쓰기: create/modify를 지원하는 컨텍스트 검증 패치(쓰기 가능한 저장소만)

• 작업: 승인된 명명된 작업 실행(허용 목록 전용, 임의 셸 없음)

• 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개의 테스트:

• 허용 및 차단된 읽기

• 경로 트래버설, 절대 경로, 심볼릭 링크 이스케이프 거부

• 민감 파일 읽기/쓰기/커밋 차단

• 쓰기 가능 저장소와 읽기 전용 저장소의 강제 적용

• 올바른/오래된 컨텍스트를 사용한 패치

• 제외된 파일을 대상으로 하는 패치

• 명명된 작업 허용 목록(성공, 알 수 없는 이름, 셸 인젝션 시도)

• 작업 시간 제한 및 출력 잘림

• Git status/diff

• 브랜치 이름 인젝션 방지 장치

• 커밋 안전 장치(빈 메시지, 민감 파일, 대량 스테이징, 사전 스테이징된 파일)

• 푸시 불가 저장소에 대한 푸시 거부

• 서버의 누락 인자 처리

라이선스

MIT