Kostenloses Tool

OpenAPI zu MCP-Server in Python

Du hast bereits eine OpenAPI-Spezifikation. So wird daraus ein funktionierender MCP-Server in Python — und das sind die Teile, die dir ein Konverter nicht abnehmen kann.

Offizielles SDK modelcontextprotocol/python-sdk (FastMCP)
Installation
pip install mcp
Ein funktionierendes MCP-Tool in Python 
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def get_order(order_id: str) -> str:
    """Look up one order by its id and return its current status."""
    return fetch_order(order_id)

mcp.run(transport="streamable-http")
Teste, was du gebaut hast Tools aus einer OpenAPI-Spec generieren

Generiert, läuft — und immer noch unsichtbar.

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.

Kostenlos starten MCP-Server-Verzeichnis erkunden

So funktioniert es

link
Spezifikation konvertieren

Der OpenAPI-Konverter macht aus jeder Operation eine MCP-Tool-Definition — in deinem Browser, ohne deine Spezifikation hochzuladen.

play_circle
In Python verdrahten

Nimm die generierten Tool-Definitionen und implementiere sie gegen deine API mit dem SDK für Python, in der Form, die oben gezeigt wird.

checklist
Die Liste zusammenstreichen

Eine konvertierte Spezifikation gibt dir ein Tool pro Operation, und das sind fast immer viel zu viele. Behalte die, die ein Agent braucht.

Von der Spezifikation zu Python

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 Python: diese Tools mit modelcontextprotocol/python-sdk (FastMCP) (pip install mcp) gegen deine API zu implementieren, in der Form, die oben gezeigt wird.

Decorators verstecken das Schema, und das ist meist genau richtig

FastMCP leitet das Input-Schema eines Tools aus deinen Type-Hints ab und seine Beschreibung aus dem Docstring. Das ist der schnellste Weg zu einem funktionierenden Server und der Grund, warum die meisten MCP-Beispiele in Python sind — es heißt aber auch, dass das, was das Modell liest, dein Docstring ist. Ein vager Docstring ist ein Tool, das der Agent falsch auswählt, und keiner deiner Tests wird das bemerken.

Was dir kein Konverter abnimmt

  • Authentifizierung. Generierter Code ruft deine API ohne Zugangsdaten auf. Header, Token oder OAuth-Flow zu verdrahten ist deine Sache.
  • Die Beschreibungen umschreiben. Eine OpenAPI-Summary ist für Entwickler geschrieben, die Doku lesen. Eine MCP-Tool-Beschreibung liest ein Modell, das entscheidet, was es aufruft. Das sind zwei verschiedene Aufgaben, und Summaries muss man nach der Konvertierung meist umschreiben.
  • Auswählen, was du bereitstellst. Ein Konverter gibt dir ein Tool pro Operation. Für die meisten APIs ist das eine Größenordnung zu viel.
  • $ref-Bodies auflösen. Dafür braucht es deine components-Sektion, sie kommen also als generisches Objekt herüber.

Warum die Anzahl der Tools so sehr zählt

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.

Verwandte Tools und Anleitungen

Generiert ist nicht dasselbe wie nutzbar

Ein konvertierter Server beweist, dass die Abbildung funktioniert hat. Einem potenziellen Kunden sagt er nichts — er kann kein Python 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.

Häufig gestellte Fragen

Die Abbildung ist mechanisch: Jede Operation wird ein Tool, ihre Summary die Beschreibung, ihre Parameter ein flaches Input-Schema. Nicht mechanisch sind Authentifizierung, Fehlerbehandlung und die Entscheidung, welche Operationen überhaupt in die Tool-Liste gehören.

Die Authentifizierung, die du selbst ergänzt. Request-Bodies hinter einem $ref, für deren Auflösung deine components-Sektion nötig ist. Und das Urteilsvermögen — ein Konverter gibt dir bereitwillig achtzig Tools, was schlechter ist als acht.

Weil Tool-Definitionen bei jeder Anfrage ans Modell gehen. Achtzig Operationen heißt achtzig Beschreibungen und achtzig Schemas im Kontext jeder Runde — dauerhaft bezahlt, während das Modell messbar schlechter darin wird, zwischen ihnen zu wählen.

Ja, und das solltest du vor dem Konvertieren wissen. OpenAPI-Summaries sind für Entwickler geschrieben, die Doku lesen; MCP-Tool-Beschreibungen liest ein Modell, das entscheidet, was es aufruft. Das sind zwei verschiedene Aufgaben, und Summaries muss man hinterher meist umschreiben.

Deploye es und lass die URL durch den MCP Inspector laufen, um Handshake und Tool-Liste zu bestätigen, danach durch den Schema-Linter, um zu sehen, ob die Beschreibungen gut genug übernommen wurden, dass ein Modell richtig wählt.

Weitere kostenlose MCP-Tools

MCP Inspector Online

MCP-Server-URL einfügen und alle Tools, Resources und Prompts sehen, mit vollständigen Schemas und rohem Request-Log. Nichts zu installieren.
MCP Server Tester

Prüfen Sie, ob Ihr MCP-Server wirklich funktioniert. URL einfügen und einen Pass/Fail-Bericht zu Verbindung, Handshake, Transport und bereitgestellten Tools erhalten.
MCP Security Scanner

Bevor Sie einen Agenten auf einen MCP-Server richten, sehen Sie, worum er bittet. Bewertet von A bis F zu Transport, Authentifizierung, Tool-Poisoning-Merkmalen und gefährlichen Parametern.
MCP Token Calculator

Tool-Definitionen werden bei jeder Anfrage gesendet, nicht einmalig. Füge deine MCP-Server-URL ein und sieh, wie viele Tokens das sind, welche Tools am schwersten sind und was es kostet.
Alle kostenlosen Tools