ATLAS-GATE MCP (VS Code 에디션)

에이전트형 AI를 위한 단일 IDE 중개 보안 게이트웨이

ATLAS-GATE는 AI 에이전트에 대해 **"계획은 곧 법이다"**를 강제하는 제로 트러스트 보안 게이트웨이입니다. 이 버전은 VS Code에 최적화되어 있으며, 기존의 이중 에이전트(Antigravity/Windsurf) 모델을 단일 고성능 MCP 브로커로 통합했습니다.

🔐 문제점: 에이전트의 혼란

AI 에이전트는 사전 승인, 감사 추적, 품질 강제 없이 모든 파일에 임의의 코드를 작성할 수 있습니다. ATLAS-GATE는 모든 파일 쓰기 작업이 디스크에 도달하기 전에 5단계 암호화 파이프라인을 통과하도록 요구함으로써 이 문제를 해결합니다.

🏗️ 해결책: 중개형 아키텍처

두 개의 개별 에이전트와 서버를 관리하는 대신, ATLAS-GATE는 이제 변경 사항의 수명 주기를 내부적으로 관리하는 단일 MCP 서버로 실행됩니다.

• 단일 서버: atlas-gate가 계획과 실행을 모두 처리합니다.

• 단일 세션: 브로커가 상태, 활성 계획 및 감사 로그를 유지합니다.

• 단일 설정: 간단한 .vscode/mcp.json 설정.

작동 방식 (5단계 파이프라인)

모든 write_file 호출은 5개의 순차적 게이트를 통과합니다:

1. 스키마: 입력 구조를 검증합니다.

2. 계획 권한: 브로커 세션 내에 활성 상태의 서명된 계획이 있는지 확인합니다.

3. 의도: 변경이 발생하는 이유를 설명하는 .intent.md 파일을 동반해야 합니다.

4. 스텁 탐지: TODO, mock, 빈 catch 등에 대한 AST 수준의 차단.

5. 감사 커밋: 디스크에 기록하고 해시 체인으로 연결된 감사 로그에 추가합니다.

🚀 퀵스타트 (VS Code)

1. 설치

git clone https://github.com/dylanmarriner/ATLAS-GATE-MCP.git
cd ATLAS-GATE-MCP
npm install

2. 자동 설정

설정 스크립트를 실행하여 VS Code MCP 구성을 생성합니다:

npm run setup:vscode

이 작업은 로컬 브로커를 가리키는 .vscode/mcp.json을 생성합니다.

3. 환경 확인

닥터 스크립트를 실행하여 모든 준비가 완료되었는지 확인합니다:

npm run doctor:vscode

🔌 MCP 클라이언트 구성

이제 VS Code(Copilot/MCP 지원 포함)에서 단일 서버를 인식합니다:

{
  "servers": {
    "atlas-gate": {
      "command": "node",
      "args": ["/path/to/bin/atlas-gate-vscode.js"],
      "env": {
        "ATLAS_WORKSPACE_ROOT": "${workspaceFolder}",
        "ATLAS_HOST_IDE": "vscode"
      }
    }
  }
}

⚡ 중개형 워크플로우

1. 초기화: 작업 공간 루트와 함께 begin_session을 호출합니다.

2. 계획: 계획을 초안으로 작성하고 lint_plan을 호출합니다.

3. 승인: save_plan을 호출합니다. 브로커가 계획에 서명하고 현재 세션에 고정합니다.

4. 실행: write_file을 호출합니다. 브로커가 세션에 고정된 계획에 따라 자동으로 검증합니다.

5. 검증: verify_phase를 호출하여 변경 사항의 무결성을 확인합니다.

⚙️ 주요 스크립트

🛡️ 거버넌스 불변성

ATLAS-GATE는 완전한 감사 가능성과 코드 품질을 보장하기 위해 8가지 기계적 불변성(I1–I8)을 강제합니다. 경로 제한(I3)부터 제로 스텁 강제(I4)까지, 브로커는 AI 에이전트가 정의된 가드레일 내에 머물도록 보장합니다.

🤝 기여하기

품질 기준은 기계적으로 강제됩니다. TODO, 스텁 구현 또는 빈 오류 핸들러가 포함된 PR은 AI 에이전트를 관리하는 동일한 파이프라인에 의해 거부됩니다.

작성자: Dylan Marriner · 버전: 2.1.0 · 라이선스: MIT