transparent-openapi-mcp

Ein KISS-MCP-Server, der OpenAPI-v3-Spezifikationen 1:1 transparent auf MCP-Tools abbildet – eine Änderung an einer geladenen OpenAPI-Spezifikation erfordert niemals eine Änderung am Code dieses Servers.

Verwendung als Claude Code MCP-Server

Drei Schritte: Image erstellen, serverseitige Konfiguration einrichten und in Claude Code einbinden.

1. Image erstellen

./podman_build.sh

2. Server konfigurieren

Der Server benötigt eine eigene Konfiguration: eine lokale Datei (in den Container gemountet), die auf eine Konfigurationsliste verweist, die wiederum auf Ihre OpenAPI-Spezifikation(en) und Backend(s) verweist. Siehe examples/README.md für die vollständige Referenz – was jede Datei enthält, die <prefix>_<operationId>-Tool-Namensregel und ein lauffähiges Beispielset, das nachweislich Ende-zu-Ende funktioniert.

3. In Claude Code einbinden

Claude Code muss wissen, wie der Container als stdio-Unterprozess gestartet wird. Siehe examples/claude-code/README.md für den genauen MCP-Konfigurationseintrag, der hinzugefügt werden muss, und wie er mit Ihrer serverseitigen Konfiguration aus Schritt 2 zusammenhängt.

Nach dem Hinzufügen führen Sie /mcp in einer Claude Code-Sitzung aus und bestätigen, dass transparent-openapi-mcp mit seinen Tools angezeigt wird.

Related MCP server: ControlAPI-MCP

Mit dem mitgelieferten Beispiel testen

Bevor Sie Ihre eigene echte Spezifikation/Backend einbinden, können Sie mit dem mitgelieferten Minimalbeispiel überprüfen, dass die gesamte Kette funktioniert:

./podman_build.sh

mkdir -p ~/t-o-m-config
cp examples/*.example.json ~/t-o-m-config/
cd ~/t-o-m-config
mv local-config.example.json local-config.json
mv config-list.example.json config-list.json
mv minimal-openapi.example.json minimal-openapi.json

# in another terminal, serve that directory:
cd ~/t-o-m-config && python3 -m http.server 8000

# back in the first terminal:
./podman_run.sh ~/t-o-m-config/local-config.json

Siehe examples/README.md für die vollständige Schritt-für-Schritt-Anleitung, einschließlich der Frage, wie Sie ein Tool tatsächlich aufrufen und ein Ergebnis sehen (dies startet nur den Server – er wartet still auf stdio, was dem korrekten MCP-Verhalten entspricht).

Design-Dokumente

Siehe docs/core-mcp-server/requirements.md und docs/core-mcp-server/architecture.md für den vollständigen Anforderungssatz (R-CTRL, R-DEPLOY, R-CFG, R-BOOT, R-TOOLS, R-FWD, R-STACK, R-RELEASE) und das Design.# transparent-openapi-mcp

Ein KISS-MCP-Server, der OpenAPI-v3-Spezifikationen 1:1 transparent auf MCP-Tools abbildet – eine Änderung an einer geladenen OpenAPI-Spezifikation erfordert niemals eine Änderung am Code dieses Servers.

Verwendung als Claude Code MCP-Server

Drei Schritte: Image erstellen, serverseitige Konfiguration einrichten und in Claude Code einbinden.

1. Image erstellen

./podman_build.sh

2. Server konfigurieren

Der Server benötigt eine eigene Konfiguration: eine lokale Datei (in den Container gemountet), die auf eine Konfigurationsliste verweist, die wiederum auf Ihre OpenAPI-Spezifikation(en) und Backend(s) verweist. Siehe examples/README.md für die vollständige Referenz – was jede Datei enthält, die <prefix>_<operationId>-Tool-Namensregel und ein lauffähiges Beispielset, das nachweislich Ende-zu-Ende funktioniert.

3. In Claude Code einbinden

Claude Code muss wissen, wie der Container als stdio-Unterprozess gestartet wird. Siehe examples/claude-code/README.md für den genauen MCP-Konfigurationseintrag, der hinzugefügt werden muss, und wie er mit Ihrer serverseitigen Konfiguration aus Schritt 2 zusammenhängt.

Nach dem Hinzufügen führen Sie /mcp in einer Claude Code-Sitzung aus und bestätigen, dass transparent-openapi-mcp mit seinen Tools angezeigt wird.

Mit dem mitgelieferten Beispiel testen

Bevor Sie Ihre eigene echte Spezifikation/Backend einbinden, können Sie mit dem mitgelieferten Minimalbeispiel überprüfen, dass die gesamte Kette funktioniert:

./podman_build.sh

mkdir -p ~/t-o-m-config
cp examples/*.example.json ~/t-o-m-config/
cd ~/t-o-m-config
mv local-config.example.json local-config.json
mv config-list.example.json config-list.json
mv minimal-openapi.example.json minimal-openapi.json

# in another terminal, serve that directory:
cd ~/t-o-m-config && python3 -m http.server 8000

# back in the first terminal:
./podman_run.sh ~/t-o-m-config/local-config.json

Siehe examples/README.md für die vollständige Schritt-für-Schritt-Anleitung, einschließlich der Frage, wie Sie ein Tool tatsächlich aufrufen und ein Ergebnis sehen (dies startet nur den Server – er wartet still auf stdio, was dem korrekten MCP-Verhalten entspricht).

Design-Dokumente

Siehe docs/core-mcp-server/requirements.md und docs/core-mcp-server/architecture.md für den vollständigen Anforderungssatz (R-CTRL, R-DEPLOY, R-CFG, R-BOOT, R-TOOLS, R-FWD, R-STACK, R-RELEASE) und das Design.