GitOps Safe MCP

spectrenet-mcp 커밋 2e63f009d8f4642e17398685baef0251811d6637에서 추출한 의도적으로 범위를 좁힌 stdio MCP 서버입니다. 다음만 노출합니다:

• repository_status: Git 상태 및 최근 커밋 5개(읽기 전용).

• diff_summary: 스테이징되지 않은 diff 통계 및 작업 트리 이름(읽기 전용).

• tofu_validate: tofu fmt -check -recursive 및 tofu validate -no-color.

• ansible_syntax: 고정/운영자 관리 ansible-playbook --syntax-check 명령을 통한 자체 포함된 단일 YAML 플레이북.

Git 쓰기, OpenTofu plan/apply, Ansible 플레이북 실행, 셸 또는 임의 명령 도구는 없습니다.

중요한 Ansible 경고

Ansible syntax-check는 무해함이 보장되지 않습니다. lookup 플러그인과 일부 컬렉션/플러그인 로딩은 플레이북을 파싱하는 동안 코드를 실행할 수 있습니다. 구성된 저장소와 종속성을 신뢰된 코드로 취급하십시오. 이 서버를 전용 비특권 계정, 정리된 환경, 읽기 전용 저장소 마운트, 프로덕션 자격 증명 없음, 제한된 네트워크/파일시스템 액세스로 실행하십시오. 실행 파일은 운영자가 관리하는 절대 경로(또는 운영자가 소유한 절대 경로 래퍼)로 구성되어야 하며, 도구 인수에서 절대 허용되지 않습니다.

Related MCP server: Gumi-MCP

안전 경계

구성된 모든 하위 경로와 요청된 플레이북은 (심볼릭 링크 포함) 확인되며, 상대 경로여야 하고, 존재해야 하며, 허용된 확인 루트보다 엄격히 아래에 있어야 합니다. 모든 하위 프로세스는 동일한 명시적 최소 허용 목록(PATH, 기본 사용자/로케일/터미널/임시 변수 및 XDG_*)을 받습니다. Ansible만 추가로 포함된 ANSIBLE_CONFIG를 받습니다. 관련 없는 프로세스 자격 증명, 클라우드 토큰 및 공급자 비밀은 상속되지 않습니다. 하위 프로세스는 argv 배열, 고정 동사/플래그, 시간 제한 및 제한된 stdout/stderr를 사용합니다. 감사 JSONL에는 타임스탬프, UUID 요청 ID, 도구/대상, 비변경 마커, 종료 코드, 시간 초과 상태 및 기간이 포함되지만 명령 출력이나 환경 값은 포함되지 않습니다.

이것은 샌드박스가 아닌 심층 방어입니다. Security 및 Architecture를 참조하십시오.

설치 및 실행

Python 3.11+ 및 uv를 권장합니다:

uv sync --extra test
cp .env.example .env.reference  # reference only; the package does not load dotenv files
uv run gitops-safe-mcp

서비스 관리자 또는 비밀/구성 관리자로 설정을 주입하십시오. 감사 디렉터리가 서비스/운영자만 쓸 수 있는지 확인하십시오.

검증

uv run --extra test pytest
uv run python -m compileall -q src tests
uv build

테스트는 임시 가짜 저장소와 가짜 실행 파일을 사용합니다. 실제 인프라에 대해 OpenTofu 또는 Ansible을 실행하지 않습니다.