ssmcp Unified Workspace Bridge
Entdecke die Maschinen und ihre Fähigkeiten
Rufe zuerst list auf. Verwende den optionalen title jedes Clients, um seine Aufgabe zu verstehen, und überprüfe dann seinen name und cwd. Wähle Clients anhand ihrer zurückgegebenen id aus; Titel, Namen und Hostnamen sind Labels und können sich wiederholen. Verwende tools.search(clientId,{query,limit:20}) innerhalb von code_mode, um kompakte Tool-Zusammenfassungen zu finden; fordere include_schemas:true an, um den vollständigen nativen Deskriptor vor dem Aufruf zu erhalten. Bei älteren Brokern verwende list({client_id}) oder tools(clientId,cursor) Paging. Respektiere die Berechtigungs- und Genehmigungsrichtlinien jedes nativen Backends.
Halte jeden Tool-Katalog-Durchlauf auf seinem zurückgegebenen Cursor. Seine Seiten teilen sich einen Snapshot, selbst wenn sich das native Tool-Verzeichnis ändert; starte eine neue Cursor-freie Anfrage, um Aktualisierungen zu entdecken. Ein Client behält maximal vier Snapshots und insgesamt 64 MiB serialisiertes JSON. Jeder erfolgreiche Seitenlesevorgang verlängert das 120-Sekunden-Inaktivitäts-Timeout, aber ein Snapshot läuft maximal 900 Sekunden nach seiner Erstellung ab. Ungültige Cursor verlängern es nicht, und die Wiederverwendung eines unveränderten Katalogs setzt seine Erstellungszeit nicht zurück; LRU- und Kapazitätsgrenzen können ihn früher entfernen. Starte die Entdeckung neu, wenn der Server meldet, dass ein Snapshot abgelaufen oder entfernt wurde.
Aktuelle Clients verbinden sich als type:"shell" und bieten ein Haupt-interaktives Terminal, zusätzliche unabhängige Terminals, unabhängige Befehlsjobs, Dateien und Kontext-Tools, ohne dass ein Harness erforderlich ist. Die Hintergrundentdeckung überprüft installierte Provider und registriert nur Schnittstellen, deren Version, Startrichtlinie, Handshake und aktueller Katalog nutzbar sind. ssmcp.harnesses.list meldet Status und Diagnose; ein nicht verfügbarer Provider entfernt Shell oder andere Tools nicht. Entferne veraltete -t, --type, --backend und nachfolgende Backend-Argumente aus Startbefehlen.
Die Entdeckung darf keine Laufzeiten, Abhängigkeiten oder Harnesses installieren, keine Modellanfragen senden oder native Berechtigungen lockern. Behandle Offline-Paketcaches nicht als Beweis dafür, dass nichts installiert wird. Provider ohne verifizierten sicheren Start bleiben nicht verfügbar. Pi-Discovery verbindet sich nur mit einer explizit konfigurierten, bereits initialisierten nativen JSONL-RPC-Sitzung über SSMCP_PI_RPC_SOCKET. Der absolute Unix-Socket und sein direktes übergeordnetes Verzeichnis müssen dem aktuellen UID gehören, keine Gruppen-/Anderen-Berechtigungen haben und keine Symlinks sein; die verbundene Peer-UID, installierte Binärdatei und Version werden vor einem fünfsekündigen get_state-Handshake überprüft. OpenCode-Discovery verbindet sich nur mit einem vorhandenen Dienst unter http://127.0.0.1:PORT/ (SSMCP_OPENCODE_URL, OPENCODE_PASSWORD). Der explizite Port und Root-Pfad sind erforderlich; Proxys, Weiterleitungen, andere Hosts, Benutzerinfo, Query und Fragment werden abgelehnt. Native Discovery liest nur Info und OpenAPI; Event-Subscription ist verzögert. Fehlende Endpunkte bedeuten nicht verfügbar. Kein Adapter startet einen externen Dienst oder deaktiviert Benutzererweiterungen, um einen vollständigen Katalog zu erstellen.
list und tools verwenden ein Registry, das native Schema und Deskriptoren mit Routing-Namespaces bewahrt. Namespaces umfassen codex.*, claude.*, pi.*, opencode.* und playwright.*, wenn seine native MCP-Entdeckung erfolgreich ist; genaue Namen stammen aus dem aktuellen Katalog. Codex-MCP-Tools werden durch natives mcpServerStatus/list aufgelistet und über mcpServer/tool/call weitergeleitet; wähle entdeckte codex.mcp.* Namen ohne Hardcodierung eines Servers. Pi stellt nur die pi.rpc, ssmcp.pi.events, ssmcp.pi.requests und ssmcp.pi.respond Bridge-Operationen zur Verfügung, wenn verfügbar. Eine CLI-Installation oder bekannte Steuerbefehlsliste ist keine Aufzählung seiner Modell-, Plugin- oder internen MCP-Tool-Schemata.
Lese ssmcp://guide, ssmcp://limits und ssmcp://clients über MCP-Ressourcen oder resources.read(uri) innerhalb von code_mode. Verwende resources.templates() für Client-spezifische Ressourcen. Überprüfe aktuelle Kataloge, wenn ein verbundener Client eine ältere Version hat.
code_mode läuft auf dem MCP-Server. Sein Dateisystem und Loopback-Netzwerk sind nicht der Arbeitsbereich des Aufrufers. Um eine Sandbox oder einen anderen Computer in einen Transfer einzubeziehen, starte einen separaten ssmcp-Client in dieser Umgebung und wähle seine zurückgegebene ID. Starte es aus dem Verzeichnis, das freigegeben werden soll:
cd /pfad/zu/workspace
ssmcp --name workspace --title "Beschreibe die Aufgabe dieser Sitzung" --allow DEIN_GITHUB_LOGIN@github [email protected]
Verwende das konfigurierte SSH-Ziel und die autorisierte Identität des Operators. Kopiere keine privaten SSH-Schlüssel, deaktiviere keine Host-Key-Prüfungen oder umgehe eine Netzwerkrichtlinie. Wenn die Aufruferumgebung keine Verbindung herstellen kann, melde diese genaue Einschränkung und setze die Arbeit auf erreichbaren Peers fort.
Verfügbare Skills und Anweisungsdateien inspizieren
Verwende context.roots(id), um den Arbeitsbereich und alle expliziten schreibgeschützten Kontext-Roots zu sehen. Beginne mit skills.view(id) für einen kompakten Markdown-Index oder skills.list(id,options) für Metadaten. Folge next_cursor mit denselben Scan-Optionen. Namen können sich wiederholen; wähle nach Root und Pfad, rufe dann skills.read(id,{path}) für die vollständige SKILL.md auf.
agents.resolve(id,{path:"src/lib.rs"}) gibt Anweisungsursprünge und genauen Inhalt in Root-zu-Ziel-Reihenfolge zurück. agents.list gibt nur Ursprünge zurück, und agents.read liest eine ausgewählte Datei. In jedem Verzeichnis wählt ssmcp die erste nicht leere AGENTS.override.md, AGENTS.md oder agents.md aus. Überprüfe Herkunft und Diagnose, bevor du relevante Anweisungen anwendest.
Der Standard-Root ist der Startarbeitsbereich des Clients. Ein Operator kann bis zu acht schreibgeschützte Roots mit wiederholtem --context-root PFAD hinzufügen; wähle ihre zurückgegebenen IDs explizit mit der root-Option. Ein Root, der direkt Skill-Ordner enthält, kann mit paths:["."] gescannt werden. Diese Kontext-Roots erweitern nicht den normalen Dateischreibzugriff. Dies ist eine aktuelle Festplattenansicht, kein Inventar des geladenen Prompts eines Backend-Modells. Die Metadatenanalyse verwendet die dokumentierte YAML-Teilmenge; lese Diagnosen und schließe nicht auf fehlende Beschreibungen aus Textkörpern.
Befehle ausführen und verwalten
Verwende exec für unabhängige Befehle mit Exit-Status und getrenntem stdout/stderr. Übergib argv-Arrays, ein optionales vorhandenes cwd innerhalb des autorisierten Arbeitsbereichs und optionale env-Überschreibungen. Jeder Start erzeugt einen unabhängigen Prozess und Pipes; es stellt keine Eingabe über das interaktive PTY in die Warteschlange. Für Pipelines oder Shell-Expansion rufe die Plattform-Shell explizit auf. Ein Befehl erbt keine späteren cd- oder Umgebungsänderungen innerhalb des interaktiven Terminals.
const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("Wähle einen Online-Client aus der Liste");
return await exec.run(client.id, {
command: ["git", "status", "--short"],
cwd: client.cwd,
wait_ms: 5000,
max_bytes: 16384
});
Lesen job_id, running, state, exit_code, stdout, stderr, die beiden Output-Cursor und snapshot. Ein erfolgreicher Start bestätigt nur den Start. Wenn Prozessmetadaten pid_role enthalten, behalte es bei der PID-Meldung bei; eine Supervisor-PID ist nicht die Befehl-PID. Bewerte den endgültigen Exit nur, wenn running:false; Exit-Codes ungleich Null sind Befehlsfehler, selbst wenn der Helfer erfolgreich aufgelöst wurde. snapshot enthält den neuesten atomaren Zustand und Output-Metadaten. wait_timed_out zeichnet den Warteschritt auf; der nachfolgende Lesevorgang kann bereits den Abschluss zeigen.
Halte das Warten getrennt von der Befehlslebensdauer. wait_ms standardmäßig 5000 und akzeptiert 0..60000; Ablauf lässt den Befehl weiterlaufen. Das timeout_ms eines Befehls standardmäßig 0, was bedeutet, dass es keine Ausführungsfrist gibt; ein positiver Wert bis zu 900000 beendet seinen Prozessbaum bei Ablauf. Setze das äußere code_mode.timeout_ms lang genug für die gesamte Sequenz. Ein JavaScript-Deadline macht keine bereits gestarteten Befehle rückgängig.
Für lange Arbeiten starte mit exec.start(clientId,{command,cwd}) und gib seine job_id umgehend zurück. Setze in späteren Anfragen fort:
| Helfer | Zweck |
|---|---|
exec.list(clientId) | Finde laufende und aufbewahrte abgeschlossene Jobs |
exec.status(clientId,jobId) | Überprüfe aktuellen Zustand, Dauer, Exit-Code und Artefakt-Metadaten |
exec.wait(clientId,jobId,{wait_ms:5000}) | Warte auf den Abschluss innerhalb eines begrenzten Intervalls |
exec.read(clientId,jobId,{stdout_cursor,stderr_cursor,max_bytes,wait_ms}) | Lese inkrementellen Output und einen atomaren snapshot |
exec.cancel(clientId,jobId) | Beende den eigenen Prozessbaum und überprüfe den zurückgegebenen Zustand |
exec.forget(clientId,jobId) | Gib den aufbewahrten Datensatz eines abgeschlossenen Jobs frei |
exec.events(clientId,{cursor,max_events,wait_ms}) | Lese begrenzte Befehl-Ereignisse |
Führe stdout_cursor und stderr_cursor getrennt zwischen Lesevorgängen. Jeder Stream gibt maximal 32768 Bytes pro Lesevorgang zurück; *_base64 bewahrt genaue Bytes und *_eof identifiziert sein Ende. Wenn *_truncated wahr ist, lese ältere Bytes vom entsprechenden snapshot.stdout.artifact oder snapshot.stderr.artifact. Wenn die Beobachtung nach dem Start fehlschlägt, überprüfe die job_id des Fehlers mit Status/Lesen, bevor du es erneut versuchst; starte keine doppelten Arbeiten.
Verwende exec.parallel(clientId,[{command:[...]},...],{concurrency:4}) für bis zu 32 Befehle mit 1..8 Workern. Jeder Worker wartet, bis sein Befehl tatsächlich endet, bevor er den nächsten startet; ein anfängliches wait_ms:0 gibt niemals einen laufenden Slot frei. Ergebnisse behalten die Eingabereihenfolge bei und enthalten fulfilled/value oder rejected/reason. Beobachtungsfehler behalten job_id, wenn verfügbar, und stoppen diesen Worker; nie gestartete Warteschlangeneinträge werden als not_started:true markiert. Überprüfe jeden Exit-Code und stelle unsichere Jobs wieder her, bevor du es erneut versuchst. Interne begrenzte Wartezeiten zählen zum 128-Aufruf-Budget von code_mode und zum äußeren Timeout. Verwende exec.start für persistente Server. Paralleler Output standardmäßig 2048 Bytes pro Stream.
Erwarte maximal 32 laufende Jobs und 128 aufbewahrte Datensätze pro Client. Beim Erreichen der Datensatzgrenze verdrängen neue Starts den ältesten abgeschlossenen Job; laufende Jobs bleiben registriert. Jobs überleben den Abschluss von code_mode, stoppen aber bei Client-Trennung oder Neuladung. forget löscht nicht sofort Output-Artefakte. Verwende exec.* für Befehle; jobs.* verwaltet rsync-Transfer-Jobs. Verwende terminal.*, wenn eine gemeinsame interaktive Shell erforderlich ist, und schließe nicht auf Befehlsabschluss aus einem Terminal-Lesevorgang.
Hintergrundeingabe schreiben und Terminals auswählen
Starte einen Befehl mit stdin:"pipe", bevor du exec.write(clientId,jobId,{data,close_stdin:true}) verwendest. Verwende data_base64 für binäre Eingabe; gib niemals beide Formen an. Jeder Schreibvorgang ist auf 32 KiB begrenzt. Überprüfe written, remaining_bytes, timed_out und closed; wiederhole nur das ungeschriebene Suffix. Das Schließen der Eingabe sendet EOF, nachdem alle Bytes akzeptiert wurden. Eingabekörper werden nicht in Audit-Protokolle kopiert.
Verwende terminal.open(clientId,{name,cwd,select}) für eine unabhängige interaktive Shell, dann terminal.write/read/status/resize mit seiner terminal_id. Halte Output-Cursor getrennt. terminal.list meldet die ausgewählte lokale Ansicht; terminal.select ändert die Ansicht und das menschliche Tastaturziel, während andere Sitzungen weiterlaufen. F7 durchläuft Sitzungen, F6 wählt Audit-Protokolle aus. Das Weglassen von terminal_id zielt immer auf main, unabhängig von der ausgewählten Ansicht. terminal.close beendet eine zusätzliche Sitzung; main endet mit der Verbindung. Es können maximal 16 Terminals geöffnet sein.
Übergib controller:{name,model} mit der äußeren code_mode-Anfrage, wenn der aktuelle Aufrufer/das aktuelle Modell bekannt ist. Der Client zeigt diese Deklaration als vom Aufrufer gemeldet an, nicht als verifizierte Provider-Identität. Rate niemals ein Modell aus einem Anwendungsnamen. MCP-ClientInfo kann die Anwendung identifizieren; unbekannte Modelle bleiben unbekannt. Überprüfe list's controller_metadata, bevor du dich auf alte Clients verlässt, um Deklarationen anzuzeigen.
Verwende cua.status und native cua-Screenshot/Input/Window-Methoden für Computer-Nutzung; cua.browser teilt die Browser-Methoden. Sende Screenshots mit image(await cua.screenshot(clientId,args)) und gib Koordinaten-Metadaten getrennt zurück. Rufe einen Codex-verbundenen CUA MCP über den genauen codex.mcp.* Namen auf, der in seinem aktuellen Tool-Katalog entdeckt wurde. Bewahre native Fehler, Bildinhalte und Genehmigungszustände; rufe kein anderes Modell auf, um diese Operationen zu proxen.
Andere native Tools ausführen
const client = clients.find(c => c.id === "CLIENT_ID_FROM_LIST");
if (!client) throw new Error("Wähle einen Online-Client aus der Liste");
return await tools.search(client.id, {query:"browser", limit:10, include_schemas:true});
Suche matcht case-insensitive Name-/Beschreibungs-Substrings. Standardmäßig gibt es Namen, beobachtete Routing-Namespaces und Beschreibungen zurück, die auf 240 Unicode-Zeichen gekürzt sind; include_schemas bewahrt den vollständigen nativen Deskriptor. Behalte dieselben Client/Query/Limit/Schema-Optionen bei, wenn du mit nextCursor fortfährst. Suche reduziert die Modell-sichtbare Katalogausgabe und manuelles Paging, nicht den ersten zugrunde liegenden Seiten-Scan. Jede Seite wird immer noch autorisiert und zählt zum Aufrufbudget; verwende max_pages für begrenzte Arbeit. Eine geänderte oder abgelaufene Seite erfordert einen Neustart der Entdeckung. Übergroße Schemas schlagen explizit fehl, anstatt abgeschnitten zu werden. Siehe ssmcp://limits für Budgets; der Helfer erfordert einen aktualisierten Broker.
Rufe eine entdeckte Operation mit await call(clientId, toolName, arguments) auf. Überprüfe isError und lese structuredContent, wenn vorhanden. Kurze Ergebnisse bleiben inline; übergroße Backend-Ergebnisse geben Artefakt-Metadaten anstelle des vollständigen Körpers zurück. Warte auf jeden Aufruf. Gib nur die Ausgabe zurück, die für die Aufgabe benötigt wird. Starte niemals einen Agenten oder ein Modell über ein natives Backend, es sei denn, der Benutzer hat diese Delegierung autorisiert.
Die nativen Befehl-Primitive sind ssmcp.exec.start/list/status/wait/read/write/cancel/events, plus ssmcp.exec.forget für abgeschlossene Datensätze. Wenn ein älterer Server keine exec-Helfer hat, rufe diese entdeckten Tools mit call(clientId, toolName, arguments) auf und überprüfe das vollständige MCP-Ergebnis. Die Schemas bleiben maßgeblich. Verwende Promise.all für unabhängige native Aufrufe; jeder Aufruf wird separat autorisiert. Gleichzeitige Cargo-Befehle können immer noch um ihre gemeinsame Build-Sperre konkurrieren.
Das vorhandene Chrome des Operators wiederverwenden
Wenn der Benutzer eine vorhandene Chrome-Sitzung nennt, beginne mit call(id,"ssmcp.browser.discover",{}) und ssmcp.harnesses.list. Die Entdeckung liest Metadaten; installierte Erweiterungsdateien begründen keine gepaarte, autorisierte Verbindung. Starte kein isoliertes Profil…
[gekürzt für Übersetzung]