Subagent MCP

Subagent MCP ist ein unter der MIT-Lizenz stehendes lokales MCP, das es Codex und anderen konformen MCP-Clients ermöglicht, native externe Coding-Agent-Harnesses über einen normalisierten Lebenszyklus zu orchestrieren. Der Name der Distribution, des Repositorys und des Befehls lautet subagent-harness-mcp.

Windows Managed Preview

0.1.0a1 ist eine Vorabversion, kein Anspruch auf Provider-Bereitschaft. Das Paket enthält das stdio-MCP, versionierten lokalen Zustand, einen deterministischen Fake-Adapter, einen abgesicherten Claude-Code-Managed-Adapter, einen konservativen Windows-Runtime-Lebenszyklus und eine optional aktivierbare Localhost-Einstellungs-/Aktivitäts-UI.

Modell-IDs und Reasoning-Objekte sind provider-native opake Werte. Subagent MCP enthält keine Modell-Allowlist, wählt keinen Fallback, aktiviert keine Nutzungsguthaben und ändert keine Abrechnungseinstellungen.

Das native SDK von Claude veröffentlicht sein Provider-Ratenereignis erst nach Beginn eines Turns. Subagent MCP deaktiviert daher den 1M-Kontext, den schnellen Modus und den In-Session-Nutzungsguthaben-Befehl für jeden verwalteten Prozess. Die Canary verweigert die Ausgabe, bis das Ereignis allowed, isUsingOverage=false und abgelehnte Overage bezeugt; gewöhnliche Turns erfordern genau diese persistierte Bereitschafts-Bestätigung und unterbrechen dennoch bei jedem späteren unsicheren Raten-/Fehlerereignis. Fehlende oder unsichere Beweise pausieren die exakte Runtime-Variante. Der ausgewählte Aufwand wird erneut über die provider-native Prozessumgebung festgelegt, sodass Benutzereinstellungen und Skills ihn nicht ersetzen können.

Für 0.1.0a1 laden gewöhnliche Claude-Turns nur die native Benutzer-Einstellungsquelle. Benutzer-Skills bleiben verfügbar, aber projekt-/lokale CLAUDE.md, .claude-Hooks, Agents, Skills und deklarierte Projekt-MCPs sind deaktiviert, bis das Vertrauens-Gate implementiert ist; dies wird als explizite Fähigkeitslücke gemeldet.

Related MCP server: AgentHub

Installieren und prüfen

Nach der Veröffentlichung von 0.1.0a1 installieren Sie die exakte Vorabversion in eine isolierte Tool-Umgebung:

uv tool install subagent-harness-mcp==0.1.0a1
subagent-harness-mcp --version
subagent-harness-mcp ui

pipx install subagent-harness-mcp==0.1.0a1 wird ebenfalls unterstützt. Die UI öffnet sich nur auf einem temporären Loopback-Port und stoppt mit ihrem Prozess. Sie ist Einstellungen und schreibgeschützte Aktivität, keine Agent-Chat-Konsole.

Für einen generischen MCP-Client verwenden Sie die installierte ausführbare Datei mit festen Argumenten:

{
  "command": "subagent-harness-mcp",
  "args": ["serve"]
}

Windows-Lebenszyklus-Befehle sind explizit und unterstützen --dry-run:

subagent-harness-mcp install --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp update --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp rollback --dry-run
subagent-harness-mcp register --client codex --dry-run
subagent-harness-mcp uninstall --client codex --dry-run

Die Registrierung verwendet den offiziellen Befehl des Clients und exaktes Read-Back. Die Deinstallation bewahrt standardmäßig Konfiguration, Zustand, native Sitzungen und Worktrees auf.

Öffentlicher Vertrag

Das MCP stellt für jeden Adapter dieselben 13 Lebenszyklus-/Konfigurations-Tools bereit. Siehe Architektur, Adapter-Authoring und das Bedrohungsmodell. Versionierte Schemas befinden sich in schemas/: Konfiguration, Adapter-Manifest, normalisierter Agent-Deskriptor und MCP-Tools.

Subagent MCP besitzt nur seine expliziten Konfigurations-, Zustands-, Daten- und gestaffelten Runtime-Roots. Es verwendet niemals AgentBridge-Zustand oder bearbeitet bestehende Codex/Claude-Konfiguration, Authentifizierung, Caches, Transkripte oder Prozesse.

Entwicklung und Sicherheit

Siehe CONTRIBUTING.md für deterministische Prüfungen und SECURITY.md für private Schwachstellenmeldungen. Verwenden Sie keinen Fake-Adapter, keine statische Inspektion oder grünes CI als Beleg, dass ein Live-Provider bereit ist. Subagent MCP wird unter der MIT-Lizenz veröffentlicht.