agent-bridge-mcp

Ein MCP-Server und HTTP-Gateway, der Programmieraufgaben an Claude Code, Codex und Antigravity (agy) CLI-Sitzungen verteilt, diese Sitzungen verfolgt und optional einen Implementieren → Überprüfen → Verifizieren-Durchlauf gegen ein echtes Repository ausführt.

Status: experimentell. Dies begann als persönliche Orchestrierungseinrichtung und wird in der Hoffnung veröffentlicht, dass die Session-Routing- und Evidence-Gate-Teile für andere nützlich sind. Die Schnittstellen werden sich ändern.

Was es macht

• Session-Routing – startet und setzt Claude Code / Codex-Sitzungen pro Projekt und Thema fort, sodass Folgeaufforderungen im selben Kontext landen.

• Task-Verfolgung – jeder Dispatch wird zu einer Aufgabe mit Status, Ausgabe und Exit-Code.

• Evidence Gate – führt die von Ihnen angegebenen Testbefehle in einem Repository aus und meldet, ob die Änderung tatsächlich durch Bestehen der Tests untermauert ist, bevor Sie sie akzeptieren.

• Review-Loop – verteilt abwechselnd einen Implementierer-Agenten und einen Reviewer-Agenten, bis zu einer Revisionsgrenze, gesteuert durch die Evidence-Prüfung.

• Gateway – dieselben Fähigkeiten über HTTP + WebSocket, sodass ein Remote-Client (z. B. ein Telefon) Arbeit verteilen und Ausgabe streamen kann.

Installation

npm install -g @yukinuma/agent-bridge-mcp

Erfordert Node.js 20+ sowie die Agent-CLIs, die Sie verwenden möchten (claude, codex und/oder agy), die bereits installiert und authentifiziert sein müssen.

Eine Anmerkung zum antigravity-Agenten

agy führt einen internen Sprachserver aus und erwartet ein echtes Terminal. Wenn es von einer normalen Pipe gestartet wird, schaltet es sich ab, bevor es antwortet, was von der aufrufenden Seite nicht von einem Hängen unterscheidbar ist. Unter Windows führt dieser Adapter es daher unter winpty (gebündelt mit Git für Windows) aus und hält stdin für die Dauer des Aufrufs offen.

Zwei beachtenswerte Konsequenzen:

• winpty bricht aufgrund einer eigenen Assertion beim Herunterfahren ab, sodass sein Exit-Code nicht widerspiegelt, was agy getan hat. Wenn es über eine pty läuft, beurteilt der Adapter den Erfolg daran, ob eine Antwort zurückkam, nicht am Exit-Code, und filtert den Assertion-Text aus der erfassten Ausgabe heraus.

• Bei Timeout wird der Prozessbaum per PID getötet. Das Töten nach Image-Namen würde jedes interaktive agy treffen, das Sie woanders geöffnet haben, daher wird dies bewusst nicht getan.

Setzen Sie WINPTY_PATH oder AGY_PATH, wenn eines der Binärdateien an einem nicht standardmäßigen Ort liegt. Auf Nicht-Windows-Plattformen wird agy direkt gestartet, was ungetestet ist.

Verwendung als MCP-Server

{
  "mcpServers": {
    "agent-bridge": {
      "command": "agent-bridge-mcp",
      "env": {
        "AGENT_BRIDGE_WORKSPACE": "/path/to/your/projects"
      }
    }
  }
}

Verfügbare Tools: agent_send, agent_status, agent_sessions, agent_cancel.

Verwendung als Gateway

export ABC_AUTH_TOKEN="$(openssl rand -hex 24)"
export AGENT_BRIDGE_WORKSPACE="/path/to/your/projects"
agent-bridge-gateway

Das Gateway weigert sich ohne ABC_AUTH_TOKEN zu starten. Es gibt kein Standard-Token.

Endpunkte

/api/dispatch, /api/git/commit-push und /api/review-loop erfordern ein explizites Ziel – entweder cwd oder ein project, das innerhalb des Arbeitsbereichs aufgelöst wird. Sie geben 400 zurück, anstatt auf ein Standardverzeichnis zurückzufallen, und project-Werte, die den Arbeitsbereich verlassen, werden abgelehnt.

Sicherheit

Dieser Dienst führt Code-Agenten mit deaktivierten Sicherheitsabfragen aus. Das ist es, was unbeaufsichtigte Verteilung ermöglicht – ein Agent, der anhält, um nach Zustimmung zu fragen, hängt einfach, wenn niemand an der Tastatur ist – aber es bedeutet, dass jeder, der die API erreichen kann, beliebigen Code als der Benutzer ausführen kann, der das Gateway betreibt.

Insbesondere übergeben die CLI-Adapter:

Beide standardmäßig umgehen. Die Opt-Outs sind Adapter-Optionen; sie sind noch nicht durch die MCP-Tools oder die REST-API verdrahtet, daher ist die Umgehung über HTTP derzeit bedingungslos.

Behandeln Sie dies als privilegierten lokalen Daemon:

• Es bindet standardmäßig an 127.0.0.1. Wenn Sie AGENT_BRIDGE_HOST auf etwas anderes setzen, werden Task-Dispatch, sandbox-freie Codeausführung und Git-Push für Ihr Netzwerk freigegeben.

• Das Auth-Token ist ein einzelnes gemeinsames Geheimnis, das als Bearer-Header oder als token-Abfrageparameter gesendet wird. Abfrageparameter landen in Logs – bevorzugen Sie den Header, wo Sie können. Die Kompromittierung dieses einen Tokens entspricht der Übergabe einer Shell.

• Es gibt keine Sandboxing zwischen Projekten über die Arbeitsbereichspfadprüfung hinaus.

• /api/git/commit-push pusht zu dem Remote, den das Ziel-Repository konfiguriert hat. Es fragt vor dem Pushen nicht noch einmal.

Setzen Sie dies keinem unsicheren Netzwerk aus und führen Sie es nicht als Benutzer mit mehr Zugriff aus, als die Arbeit tatsächlich benötigt.

Entwicklung

npm install
npm run typecheck
npm run build

Lizenz

MIT