REST-Connector

Stellt REST-Endpunkte aus einer OpenAPI-3.0-Spezifikation als MCP-Tools bereit. Jede Operation wird zu einem aufrufbaren Tool; Methode, Pfad-, Query- und Header-Parameter sowie JSON-Bodies werden aus der Spezifikation abgeleitet. Der Connector eignet sich, wenn eine bestehende HTTP-API ohne eigenen MCP-Server in AI Hub nutzbar gemacht werden soll.

Flags

Flag	Beschreibung
--spec	Pfad zu einer OpenAPI-Spezifikation in JSON oder YAML.
--base-url	Basis-URL der Ziel-API. Wenn leer, nutzt der Connector servers aus der Spezifikation.
--api-key	API-Key; standardmäßig als Authorization: Bearer <key>.
--api-key-header	Eigener Headername für den API-Key, z. B. X-API-Key.

Grundlegende Verwendung

# Mit OpenAPI-Spezifikation und Basis-URL
ai-hub-cli mcp ai-hub-cli rest-connector \
  --spec openapi.json \
  --base-url https://api.example.com

# Ohne Basis-URL, wenn OpenAPI `servers` enthält
ai-hub-cli mcp ai-hub-cli rest-connector --spec openapi.json

Authentifizierung

# Bearer-Token im Authorization-Header
ai-hub-cli mcp ai-hub-cli rest-connector \
  --spec openapi.json \
  --base-url https://api.example.com \
  --api-key DEIN_API_KEY

# Eigener API-Key-Header
ai-hub-cli mcp ai-hub-cli rest-connector \
  --spec openapi.json \
  --base-url https://api.example.com \
  --api-key DEIN_API_KEY \
  --api-key-header X-API-Key

Tool-Erzeugung

OpenAPI-Element	MCP-Abbildung
operationId	Wird zum Tool-Namen. Fehlt er, erzeugt die CLI einen Namen aus HTTP-Methode und Pfad.
Pfadparameter	Werden als Pflichtparameter im Tool-Schema angelegt.
Query-/Header-Parameter	Werden mit Typ, Beschreibung, Default und Required-Status aus OpenAPI übernommen.
JSON-Request-Body	Objekt-Properties werden als Tool-Parameter abgebildet.
Antwort	Statuszeile und Body werden als Textinhalt zurückgegeben; Fehlerstatus ab 400 setzt IsError.

Unterstützt werden GET, POST, PUT, DELETE und PATCH. Für GET ist das Tool read-only markiert; DELETE, POST, PUT und PATCH erhalten passende MCP-Hints für potenziell verändernde Operationen.