Antigravity Codex MCP

Eine kontrollierte Model Context Protocol-Brücke, die es OpenAI Codex ermöglicht, Arbeiten bei Bedarf an Google Antigravity CLI zu delegieren.

Die Brücke bleibt inaktiv, bis ein Benutzer Codex ausdrücklich bittet, AGY zu verwenden. Sie autorisiert dann nur exakt das aktuelle Projekt, führt eine auf das Projekt begrenzte Konversation, synchronisiert den für Benutzer sichtbaren Dialog und beschränkt generierte Implementierungsänderungen auf eine isolierte Kopie.

Dies ist ein unabhängiges Community-Projekt. Es ist weder mit Google noch mit OpenAI verbunden und wird von keinem der beiden unterstützt oder befürwortet.

中文说明

Highlights

• Ausdrückliches Opt-in: Codex kann AGY nur aktivieren oder aufrufen, wenn der Benutzer darum bittet.

• Exakter Projektbereich: zu weit gefasste Wurzelverzeichnisse und Systemverzeichnisse werden abgelehnt.

• Standardmäßig schreibgeschützte Delegation: Es werden keine AGY-Schreib-, Befehls-, URL- oder MCP-Berechtigungen erteilt.

• Projektkonversationen: Aktive Konversations-IDs und der Delegationsverlauf bleiben über neue Codex-Aufgaben hinweg erhalten.

• Sichtbare Transkript-Synchronisierung: Über die AGY CLI eingegebene Nachrichten werden Codex bei der nächsten Synchronisierung verfügbar gemacht.

• Private-Reasoning-Filter: Denk-/Reasoning-Felder, Systemnachrichten und Checkpoints werden vor der Persistierung oder der MCP-Rückgabe ausgeschlossen.

• Isolierte Implementierung: Validierte Ganzdatei-Ersetzungen werden nur auf eine Wegwerf-Projektkopie angewendet.

• Prüfbare Läufe: Antworten, Manifeste geänderter Dateien, Verifizierungsausgaben und bereinigte Tool-Ereignisse werden lokal aufbewahrt.

Related MCP server: codex-agy-bridge

Voraussetzungen

• Node.js 20 oder neuer

• Antigravity CLI

• OpenAI Codex mit MCP-Unterstützung

Authentifizieren Sie die Antigravity CLI und stellen Sie sicher, dass agy verfügbar ist:

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

Wenn sich agy nicht im PATH befindet, setzen Sie AGY_BIN in der MCP-Konfiguration auf den Pfad zur ausführbaren Datei.

Installation

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

Fügen Sie den Server zur config.toml Ihres Codex hinzu. Ersetzen Sie die Beispielpfade durch den absoluten Klonpfad auf Ihrem Rechner:

[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'

Verwenden Sie unter macOS oder Linux die entsprechenden absoluten POSIX-Pfade und lassen Sie AGY_BIN normalerweise weg, wenn sich agy im PATH befindet.

Installieren Sie den enthaltenen Codex-Skill, damit Codex dem Opt-in-Workflow folgt:

$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

Starten Sie Codex neu, nachdem Sie die MCP-Konfiguration geändert oder den Skill installiert haben.

Verwendung

1. Öffnen Sie ein beliebiges Projektverzeichnis in Codex.

2. Arbeiten Sie normal weiter; die AGY-Brücke bleibt inaktiv.

3. Bitten Sie ausdrücklich: Load AGY and review this project.

4. Codex aktiviert den Lesezugriff für genau dieses Projekt und startet dessen AGY-Konversation oder verwendet sie erneut.

5. Codex delegiert Analyse, Review, Fortsetzung oder isolierte Implementierung, je nach Bedarf.

6. Bitten Sie Codex: Disable AGY for this project, um die exakte Projektberechtigung zu entziehen, während der lokale Audit-Verlauf erhalten bleibt.

Um dieselbe Konversation direkt einzusehen oder daran teilzunehmen:

agy --conversation=<conversation_id>

Nachdem Sie Nachrichten über die AGY CLI gesendet haben, bitten Sie Codex, sync the AGY conversation auszuführen. antigravity_continue synchronisiert ebenfalls vor und nach jeder Folgeanfrage. Die Synchronisierung erfolgt bei Bedarf und ist kein Live-Push-Kanal. Vermeiden Sie daher gleichzeitiges Senden von Codex und AGY CLI.

MCP-Tools

Modellaufrufe erfolgen nur über die Tools start, ask, continue, review und execute. Gesundheit, Status, Verlauf, Laufprüfung und Transkript-Synchronisierung verbrauchen keinen AGY-Modell-Turn.

Projektlokaler Zustand

Jedes aktivierte Projekt erhält ein ignoriertes lokales Zustandsverzeichnis:

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

• project.json zeichnet den Opt-in-Status und die aktive Konversation auf.

• sessions.jsonl zeichnet delegierte Aufrufe und die Token-Nutzung auf.

• transcripts enthält nur sichtbare Benutzer-/Assistenten-Datensätze und bereinigte Tool-Spuren.

• runs enthält isolierte Implementierungs-Arbeitsbereiche und Audit-Ergebnisse.

Dieses Verzeichnis ist von der Quellkopie ausgeschlossen und wird von Git ignoriert. Committen Sie es nicht manuell, da es private Projekt- oder Konversationsdaten enthalten kann.

Sicherheitsmodell

Die Projektaktivierung fügt atomar nur exakt das Wurzelverzeichnis zu den trustedWorkspaces- und read_file(...)-Erlaubnisregeln von Antigravity hinzu. Die Deaktivierung entfernt nur genau diese Einträge.

Die isolierte Implementierung lehnt ab:

• absolute Pfade und Parent-Traversal;

• das Löschen von Dateien;

• geheime Dateien, Abhängigkeiten, Build-Ausgaben, Metadaten und symbolische Links;

• mehr als 50 geänderte Dateien;

• mehr als 2.000.000 Ersetzungszeichen.

Die Transkript-Pipeline entfernt rekursiv private Reasoning-Felder und schließt System-/Checkpoint-Datensätze aus, bevor sie den Projektspiegel schreibt. Siehe SECURITY.md für Hinweise zur Meldung und zu Einschränkungen.

Entwicklung

npm ci
npm test
npm run smoke:mcp

Live-Prüfungen erfordern eine authentifizierte AGY CLI und verbrauchen Modellkontingent:

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 ist in sich geschlossen. smoke:mcp prüft außerdem die lokale AGY-Binärdatei, während die übrigen Smoke-Tests die Projektautorisierung ändern oder Kontingent verbrauchen können.

Lizenz

MIT