Antigravity Codex MCP

OpenAI Codex가 요청 시 Google Antigravity CLI에 작업을 위임할 수 있게 해주는 제어된 Model Context Protocol 브리지입니다.

이 브리지는 사용자가 Codex에게 AGY를 사용하도록 명시적으로 요청하기 전까지 유휴 상태를 유지합니다. 그런 다음 정확한 현재 프로젝트에만 권한을 부여하고, 프로젝트 범위의 대화를 유지하며, 사용자에게 표시되는 대화를 동기화하고, 생성된 구현 변경 사항을 격리된 복사본에 한정합니다.

이는 독립적인 커뮤니티 프로젝트입니다. Google 또는 OpenAI와 제휬하거나 보증하지 않습니다.

中文说明

주요 기능

• 명시적 옵트인: 사용자가 요청하지 않는 한 Codex는 AGY를 활성화하거나 호출할 수 없습니다.

• 정확한 프로젝트 범위: 광범위한 루트 및 시스템 디렉터리는 거부됩니다.

• 기본적으로 읽기 전용 위임: AGY 쓰기, 명령, URL 또는 MCP 권한이 부여되지 않습니다.

• 프로젝트 대화: 활성 대화 ID와 위임 기록은 새 Codex 작업에서도 유지됩니다.

• 표시 가능한 대화록 동기화: AGY CLI를 통해 입력된 메시지는 다음 동기화 시 Codex에서 사용할 수 있습니다.

• 비공개 추론 필터: thinking/reasoning 필드, 시스템 메시지 및 체크포인트는 영구 저장 또는 MCP 반환 전에 제외됩니다.

• 격리된 구현: 검증된 전체 파일 교체는 일회용 프로젝트 복사본에만 적용됩니다.

• 감사 가능한 실행: 응답, 변경 파일 매니페스트, 검증 출력 및 정리된 도구 이벤트가 로컬에 보존됩니다.

Related MCP server: codex-agy-bridge

요구 사항

• Node.js 20 이상

• Antigravity CLI

• MCP를 지원하는 OpenAI Codex

Antigravity CLI를 인증하고 agy를 사용할 수 있는지 확인합니다.

agy --version
agy -p "Reply exactly: AGY_OK" --output-format json

agy가 PATH에 없으면 MCP 구성에서 AGY_BIN을 실행 파일 경로로 설정합니다.

설치

git clone https://github.com/ustc-fyk/antigravity-codex-mcp.git
cd antigravity-codex-mcp
npm ci
npm test

Codex config.toml에 서버를 추가합니다. 예제 경로를 사용자 컴퓨터의 절대 클론 경로로 바꿉니다.

[mcp_servers.antigravity]
command = 'node'
args = ['C:\path\to\antigravity-codex-mcp\src\index.js']
cwd = 'C:\path\to\antigravity-codex-mcp'
enabled = true
required = false
startup_timeout_sec = 20
tool_timeout_sec = 900
default_tools_approval_mode = 'prompt'
enabled_tools = [
  'antigravity_health',
  'antigravity_project_status',
  'antigravity_enable_project',
  'antigravity_disable_project',
  'antigravity_start_session',
  'antigravity_get_active_session',
  'antigravity_list_sessions',
  'antigravity_sync_conversation',
  'antigravity_get_transcript',
  'antigravity_ask',
  'antigravity_continue',
  'antigravity_review',
  'antigravity_execute',
  'antigravity_list_runs',
  'antigravity_get_run',
]

# Optional when agy is not available on PATH:
[mcp_servers.antigravity.env]
AGY_BIN = 'C:\path\to\agy.exe'

macOS 또는 Linux에서는 해당하는 절대 POSIX 경로를 사용하고, agy가 PATH에 있으면 일반적으로 AGY_BIN을 생략합니다.

포함된 Codex Skill을 설치하여 Codex가 옵트인 워크플로를 따르도록 합니다.

$skillRoot = Join-Path $env:USERPROFILE ".codex\skills\agy-project-assistant"
New-Item -ItemType Directory -Force $skillRoot | Out-Null
Copy-Item ".\skills\agy-project-assistant\SKILL.md" $skillRoot

MCP 구성을 변경하거나 Skill을 설치한 후 Codex를 다시 시작합니다.

사용법

1. Codex에서 프로젝트 디렉터리를 엽니다.

2. 정상적으로 작업합니다. AGY 브리지는 유휴 상태를 유지합니다.

3. 명시적으로 요청합니다: Load AGY and review this project.

4. Codex는 해당 정확한 프로젝트에 대한 읽기 액세스를 활성화하고 AGY 대화를 시작하거나 재사용합니다.

5. Codex는 분석, 검토, 계속 또는 격리된 구현을 적절하게 위임합니다.

6. Disable AGY for this project를 요청하면 로컬 감사 기록을 유지하면서 정확한 프로젝트 권한을 취소합니다.

동일한 대화를 직접 검사하거나 참여하려면:

agy --conversation=<conversation_id>

AGY CLI를 통해 메시지를 보낸 후 Codex에 sync the AGY conversation을 요청하세요. antigravity_continue는 모든 후속 작업 전후에도 동기화합니다. 동기화는 실시간 푸시 채널이 아닌 요청 시 수행되므로 Codex와 AGY CLI에서 동시에 보내지 마십시오.

MCP 도구

모델 호출은 시작, 요청, 계속, 검토 및 실행 도구를 통해서만 발생합니다. 상태, 기록, 실행 검사 및 대화록 동기화는 AGY 모델 턴을 소비하지 않습니다.

프로젝트 로컬 상태

활성화된 각 프로젝트는 무시되는 로컬 상태 디렉터리를 받습니다.

.antigravity-mcp/
├── project.json
├── sessions.jsonl
├── transcripts/
│   └── <conversation-id>.jsonl
└── runs/
    └── <run-id>/
        ├── metadata.json
        ├── events.jsonl
        ├── response.md
        └── workspace/

• project.json은 옵트인 상태와 활성 대화를 기록합니다.

• sessions.jsonl은 위임된 호출과 토큰 사용량을 기록합니다.

• transcripts에는 표시 가능한 사용자/어시스턴트 레코드와 정리된 도구 추적만 포함됩니다.

• runs에는 격리된 구현 작업 공간과 감사 결과가 포함됩니다.

이 디렉터리는 소스 복사본에서 제외되며 Git에서 무시됩니다. 개인 프로젝트 또는 대화 데이터가 포함될 수 있으므로 수동으로 커밋하지 마십시오.

안전 모델

프로젝트 활성화는 정확한 루트만 Antigravity trustedWorkspaces 및 read_file(...) 허용 규칙에 원자적으로 추가합니다. 비활성화는 정확한 항목만 제거합니다.

격리된 구현은 다음을 거부합니다.

• 절대 경로 및 상위 디렉터리 탐색

• 파일 삭제

• 비밀 파일, 종속성, 빌드 출력, 메타데이터 및 심볼릭 링크

• 50개 이상의 변경된 파일

• 2,000,000자를 초과하는 교체 문자

대화록 파이프라인은 프로젝트 미러를 작성하기 전에 비공개 추론 필드를 재귀적으로 제거하고 시스템/체크포인트 레코드를 제외합니다. 보고 지침 및 제한 사항은 SECURITY.md를 참조하십시오.

개발

npm ci
npm test
npm run smoke:mcp

라이브 검사에는 인증된 AGY CLI가 필요하며 모델 할당량을 소비합니다.

npm run smoke:live
npm run smoke:execute
npm run smoke:project -- "/absolute/path/to/disposable-project"
npm run smoke:continue -- "/absolute/path/to/enabled-project"
npm run smoke:transcript -- "/absolute/path/to/enabled-project"

npm test는 자체 포함됩니다. smoke:mcp는 로컬 AGY 바이너리도 확인하는 반면, 나머 스모크 테스트는 프로젝트 권한을 변경하거나 할당량을 소비할 수 있습니다.

라이선스

MIT