Du hast bereits eine OpenAPI-Spezifikation. So wird daraus ein funktionierender MCP-Server in PHP — und das sind die Teile, die dir ein Konverter nicht abnehmen kann.
Eine Spezifikation zu konvertieren bringt dir einen Server. Es bringt dir niemanden, der ihn nutzen will. MCP Showcase macht aus demselben Endpunkt ein Live-Playground mit lesbarer Doku für jedes Tool.
Der OpenAPI-Konverter macht aus jeder Operation eine MCP-Tool-Definition — in deinem Browser, ohne deine Spezifikation hochzuladen.
Nimm die generierten Tool-Definitionen und implementiere sie gegen deine API mit dem SDK für PHP, in der Form, die oben gezeigt wird.
Eine konvertierte Spezifikation gibt dir ein Tool pro Operation, und das sind fast immer viel zu viele. Behalte die, die ein Agent braucht.
Die mechanische Hälfte ist wirklich mechanisch: Jede OpenAPI-Operation wird ein MCP-Tool, ihre Summary wird die Beschreibung, und ihre Pfad-, Query- und Body-Parameter werden zu einem einzigen flachen Input-Schema. Der OpenAPI-Konverter erledigt diesen Teil in deinem Browser, ohne deine Spezifikation hochzuladen.
Was bleibt, hat die Form von PHP: diese Tools mit
community SDKs (composer require ...) gegen deine API zu
implementieren, in der Form, die oben gezeigt wird.
MCP-Server halten eine Session; das übliche PHP-Modell mit einem Prozess pro Request tut das nicht. Ein PHP-MCP-Server läuft deshalb als langlebiger Prozess (oder über ein Framework, das dafür gebaut ist), und das ist eine größere Abweichung vom normalen PHP-Deployment als das Protokoll selbst.
$ref-Bodies auflösen. Dafür braucht es deine
components-Sektion, sie kommen also als generisches Objekt herüber.Tool-Definitionen gehen bei jeder Anfrage ans Modell, nicht einmal pro Sitzung. Achtzig Operationen heißt achtzig Beschreibungen und achtzig Schemas im Kontextfenster jeder Runde — dauerhaft bezahlt und messbar schlechter bei der Auswahl als eine kurze Liste. Der Token-Rechner zeigt, was eine bestimmte Liste kostet; der Schema-Linter zeigt, ob die Beschreibungen die Konvertierung in brauchbarem Zustand überstanden haben.
Ein konvertierter Server beweist, dass die Abbildung funktioniert hat. Einem potenziellen Kunden sagt er nichts — er kann kein PHP lesen und wird keinen Client konfigurieren, um es herauszufinden. MCP Showcase macht aus demselben Endpunkt ein Live-Playground mit Doku pro Tool, das jeder im Browser ausprobieren kann.