AI Hub API-Kommandos
Diese Kommandos nutzen AI_HUB_URL und AI_HUB_API_KEY, um mit der HTTP-API und dem MCP-Endpunkt deines Hubs zu sprechen. Sie starten keinen lokalen Connector, sondern arbeiten direkt gegen den Hub: Tools entdecken und aufrufen, Workspace-Dateien verwalten oder Workspaces als lokales Dateisystem mounten. Die URL wird bei MCP-Aufrufen automatisch auf …/api/mcp normalisiert.
connect
Verbindet sich mit der MCP-URL des Hubs (…/api/mcp), initialisiert die Verbindung wenn möglich und gibt verfügbare Tools als Tabelle aus.
ai-hub-cli connect
connect ist die schnelle Diagnose: Es initialisiert den MCP-Endpunkt, ruft tools/list ab und zeigt Name plus Beschreibung. Wenn initialize fehlschlägt, versucht der Befehl trotzdem weiter die Tool-Liste abzurufen, weil manche Server die Initialisierung weniger strikt behandeln.
tools und call
tools listet Tools aus tools/list des Hub-MCP. Mit --json erhältst du maschinenlesbare Ausgabe. call ruft ein Tool per Name auf; JSON-Argumente übergibst du mit --params.
ai-hub-cli tools
ai-hub-cli tools --json
ai-hub-cli call mein_tool --params '{"key":"value"}'
| Befehl | Parameter | Beschreibung |
|---|---|---|
tools | --json | Gibt die komplette Tool-Liste formatiert als JSON aus. |
call <tool-name> | --params '{"key":"value"}' | Übergibt ein JSON-Objekt als Tool-Argumente. Ohne Flag wird {} gesendet. |
files
files arbeitet mit Dateien in AI-Hub-Workspaces. list zeigt ID, Name, Pfad, Größe und Änderungszeitpunkt. get lädt Metadaten für eine Datei. download ruft den Dateiinhalt ab und schreibt ihn an den angegebenen lokalen Pfad.
ai-hub-cli files list <workspace-id>
ai-hub-cli files get <workspace-id> <file-id>
ai-hub-cli files download <workspace-id> <file-id> <zielpfad>
| Unterbefehl | Argumente | Beschreibung |
|---|---|---|
files list | <workspace-id> | Listet alle Dateien eines Workspaces. |
files get | <workspace-id> <file-id> | Zeigt Metadaten einer Datei. |
files download | <workspace-id> <file-id> <output-path> | Speichert den Dateiinhalt lokal. |
mount
Mountet einen Workspace per FUSE an einen lokalen Pfad. Dateien werden lazy geladen, also erst dann vom Hub abgerufen, wenn der lokale Zugriff sie wirklich liest.
ai-hub-cli mount <workspace-id> /mnt/aihub
ai-hub-cli mount <workspace-id> M:
Wähle unter Windows einen freien Laufwerksbuchstaben oder einen anderen unterstützten Mountpunkt nach der WinFsp-Installation. WSL-Nutzer können das Linux-Beispiel mit einem Linux-Pfad verwenden.