ATLAS-GATE MCP (VS Code Edition)

Das Single-IDE Brokered Security Gateway für Agentic AI

ATLAS-GATE ist ein Zero-Trust-Sicherheits-Gateway, das für KI-Agenten den Grundsatz „Pläne sind Gesetze“ durchsetzt. Diese Version ist für VS Code optimiert und konsolidiert das frühere Dual-Agent-Modell (Antigravity/Windsurf) in einen einzigen, hochperformanten MCP-Broker.

🔐 Das Problem: Agentisches Chaos

KI-Agenten können beliebigen Code in jede Datei schreiben – ohne Vorabautorisierung, ohne Audit-Trail, ohne Qualitätskontrolle. ATLAS-GATE behebt dies, indem jeder Schreibvorgang eine fünfstufige kryptografische Pipeline durchlaufen muss, bevor ein einziges Byte die Festplatte erreicht.

🏗️ Die Lösung: Brokered Architecture

Anstatt zwei separate Agenten und Server zu verwalten, läuft ATLAS-GATE nun als ein einziger MCP-Server, der intern den Lebenszyklus Ihrer Änderungen verwaltet.

• Ein Server: atlas-gate kümmert sich sowohl um die Planung als auch um die Ausführung.

• Eine Sitzung: Der Broker verwaltet den Status, aktive Pläne und Audit-Logs.

• Eine Konfiguration: Einfaches .vscode/mcp.json-Setup.

Funktionsweise (Die Fünf-Stufen-Pipeline)

Jeder write_file-Aufruf durchläuft fünf aufeinanderfolgende Stufen:

1. Schema: Validiert die Eingabestruktur.

2. Plan-Autorität: Stellt sicher, dass ein aktiver, signierter Plan in der Broker-Sitzung existiert.

3. Absicht (Intent): Erfordert eine begleitende .intent.md, die erklärt, warum die Änderung vorgenommen wird.

4. Stub-Erkennung: AST-basierte Blockaden für TODO, mock, leere catch-Blöcke usw.

5. Audit-Commit: Schreibt auf die Festplatte und fügt den Eintrag dem Hash-verketteten Audit-Log hinzu.

🚀 Schnellstart (VS Code)

1. Installation

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

2. Automatisierte Einrichtung

Führen Sie das Setup-Skript aus, um Ihre VS Code MCP-Konfiguration zu generieren:

npm run setup:vscode

Dies erstellt eine .vscode/mcp.json, die auf den lokalen Broker verweist.

3. Umgebung verifizieren

Führen Sie das Doctor-Skript aus, um sicherzustellen, dass alles bereit ist:

npm run doctor:vscode

🔌 MCP-Client-Konfiguration

VS Code (mit Copilot/MCP-Unterstützung) erkennt nun einen einzelnen Server:

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

⚡ Der Brokered-Workflow

1. Initialisieren: Rufen Sie begin_session mit Ihrem Workspace-Root auf.

2. Planen: Entwerfen Sie Ihren Plan und rufen Sie lint_plan auf.

3. Autorisieren: Rufen Sie save_plan auf. Der Broker signiert den Plan und sperrt ihn für die aktuelle Sitzung.

4. Ausführen: Rufen Sie write_file auf. Der Broker validiert die Änderung automatisch gegen den sitzungsgebundenen Plan.

5. Verifizieren: Rufen Sie verify_phase auf, um die Integrität Ihrer Änderungen zu bestätigen.

⚙️ Wichtige Skripte

🛡️ Governance-Invarianten

ATLAS-GATE erzwingt acht mechanische Invarianten (I1–I8), um vollständige Auditierbarkeit und Codequalität zu gewährleisten. Von Pfad-Einschränkung (I3) bis zur Zero-Stub-Durchsetzung (I4) stellt der Broker sicher, dass Ihre KI-Agenten innerhalb der von Ihnen definierten Leitplanken bleiben.

🤝 Mitwirken

Die Qualitätsvorgaben werden mechanisch durchgesetzt. Pull Requests, die TODOs, Stub-Implementierungen oder leere Fehlerbehandlungsroutinen enthalten, werden von derselben Pipeline abgelehnt, die auch die KI-Agenten steuert.

Autor: Dylan Marriner · Version: 2.1.0 · Lizenz: MIT