MCP-Registrierung mit AI Hub

Das Subkommando mcp verbindet einen MCP-Server mit AI Hub und proxyt Requests, Responses und Notifications zwischen beiden Seiten. Der Transport wird automatisch erkannt: Beginnt das erste nicht-Flag-Argument mit http:// oder https://, nutzt die CLI den streamable-HTTP-Transport; andernfalls startet sie das angegebene Kommando als lokalen stdio-MCP-Server.

Lokalen MCP-Server registrieren

Alles nach mcp gehört zum Child-Prozess. Dadurch bleiben Connector-Flags wie --host, --dbname oder --path unverändert erhalten und werden nicht von der Bridge verschluckt.

ai-hub-cli mcp ai-hub-cli python-executor
ai-hub-cli mcp ai-hub-cli postgres-connector --host localhost --dbname app
ai-hub-cli mcp npx -y @modelcontextprotocol/server-filesystem /data

Wenn MCP_RESTART_TIMEOUT gesetzt ist, überwacht die Bridge lokale stdio-Server. Antwortet der Child-Prozess länger als dieses Intervall nicht und schlägt auch ein Ping fehl, wird er neu gestartet.

MCP_RESTART_TIMEOUT=30s ai-hub-cli mcp ai-hub-cli filesystem-connector --path /data

Entfernten HTTP-MCP verwenden

Statt eines lokalen Prozesses kannst du eine http://- oder https://-URL übergeben. Die CLI nutzt dann den streamable-HTTP-Transport von MCP und unterstützt optionale Authentifizierungs-Header.

ai-hub-cli mcp https://remote-mcp-server.example.com/mcp

ai-hub-cli mcp \
  --mcp-header "Authorization: Bearer dein-token" \
  --mcp-header "X-API-Key: dein-api-key" \
  https://remote-mcp-server.example.com/mcp

MCP-spezifische Flags und Umgebungsvariablen

Die Flags --mcp-header, --mcp-server-key und --idle-timeout werden manuell gelesen, weil mcp das normale Cobra-Flag-Parsing deaktiviert. So kann die Bridge unbekannte Flags an lokale Child-Server weiterreichen.

Name	Gilt für	Beschreibung
--mcp-header "Name: Wert"	Remote-HTTP-MCP	Fügt einen Header zum entfernten MCP-Server hinzu; mehrfach nutzbar.
--mcp-server-key <key>	Hub-Registrierung	Übergibt beim Registrieren einen Server-Key an AI Hub.
--idle-timeout 30s	Bridge-Laufzeit	Beendet die Bridge nach Inaktivität; alternativ AI_HUB_IDLE_TIMEOUT.
MCP_RESTART_TIMEOUT=30s	Lokale stdio-Server	Startet nicht antwortende Child-Server neu.
AI_HUB_MCP_STDIO_SERVERS	Bridge-Konfiguration	JSON-Liste zusätzlicher stdio-Server, die beim Hub registriert werden.

Hinweise: HTTP(S) wird automatisch erkannt. Server-Benachrichtigungen werden kontinuierlich empfangen. Wiederhole --mcp-header für jeden Header. Nutze in Produktion HTTPS und vermeide Secrets in der Shell-History.