Anleitung: MCP-Server starten

Das Werkzeug erzeugt auf Wunsch eine Datei server.mjs: einen kleinen MCP-Server, der jeden Tool-Aufruf als HTTP-Anfrage an deine API weiterleitet. So bringst du ihn zum Laufen.

Das Gerüst ist ein Startpunkt, kein fertiges Produkt. Lies den Code, bevor du ihn einsetzt, und biete einem Modell nur die Tools an, die es wirklich braucht – besonders keine löschenden ohne Rückfrage.

1. Gerüst herunterladen

Auf der Startseite die Spezifikation laden, Tools auswählen, im Export „MCP-Server-Gerüst“ wählen und server.mjs sowie package.json herunterladen. Lege beide in einen leeren Ordner.

2. Abhängigkeit installieren

Du brauchst Node.js 18 oder neuer. Im Ordner:

npm install

Das installiert das offizielle TypeScript-SDK @modelcontextprotocol/sdk in der Version, die in package.json steht. Das Gerüst nutzt dessen Server-Klasse mit ListToolsRequestSchema und CallToolRequestSchema, damit die JSON-Schemas unverändert übergeben werden können.

3. Adresse und Zugangsdaten setzen

Der Server liest alles aus Umgebungsvariablen, nichts steht im Code:

API_BASE_URL – Basisadresse der API; voreingestellt ist der erste Eintrag unter servers (bzw. host + basePath bei Swagger 2.0).
Für jedes Sicherheitsschema eine Variable, z. B. APIKEY_KEY für einen API-Schlüssel, BEARERAUTH_TOKEN für ein Bearer-Token oder …_USER/…_PASSWORD für HTTP Basic. Die genauen Namen stehen oben in server.mjs in der Funktion applyAuth.

4. Testen

Mit dem MCP Inspector siehst du die Tools und kannst sie aufrufen (der Inspector selbst braucht laut seiner Dokumentation Node.js 22.19 oder neuer):

npx @modelcontextprotocol/inspector node server.mjs

Antwortet die API mit einem Fehlerstatus, meldet das Tool isError: true und den HTTP-Status – das Modell kann dann reagieren.

5. In einen Client eintragen

MCP-Clients starten stdio-Server als Unterprozess. Die Konfiguration sieht meist so aus (Beispiel im Format, das u. a. Claude Desktop in claude_desktop_config.json verwendet):

{
  "mcpServers": {
    "meine-api": {
      "command": "node",
      "args": ["/voller/pfad/zu/server.mjs"],
      "env": {
        "API_BASE_URL": "https://api.example.com/v1",
        "APIKEY_KEY": "dein-schlüssel"
      }
    }
  }
}

Den genauen Ort der Datei und das Format nennt die Dokumentation deines Clients.

Was das Gerüst tut

Bei tools/list liefert es die exportierten Tool-Definitionen.
Bei tools/call setzt es Pfadparameter ein, hängt Query-Parameter an, setzt Header und baut den Body (JSON oder Formular).
Es ruft die API mit fetch auf und gibt die Antwort als Text zurück; lange Antworten werden nach 100.000 Zeichen gekürzt.
Ist ein outputSchema gesetzt und die Antwort ein JSON-Objekt, liefert es zusätzlich structuredContent.