FACT COPY · DE

Faktenfassung: MCP-Code- und Schema-Bibliothek

Geprüfte, versionierte Referenzfragmente für Travel-Tools, strukturierte Ergebnisse, Fehler, Autorisierung und Tests.

Originalseite: https://travel-mcp.com/de/forschung/code-schema-bibliothek/

Erstellt
Aktualisiert
Zuletzt geprüft

Sachliche Zusammenfassung

Die Bibliothek erklärt jedes Fragment mit Vorbedingungen, Invarianten, Sicherheitsgrenze und negativer Testidee. Copy-and-paste ohne Kontext ist ausdrücklich nicht das Ziel.

Spezifikationen und Kerndaten

Zielspezifikation
MCP 2025-11-25
Schemasprache
JSON Schema 2020-12
Beispielcharakter
nicht produktionsfertig
Travel-Domäne
Offer-Suche ohne personenbezogene Daten

Bibliothek und Filter

Wählen Sie Schema, Request, Resultat oder Testfall. Der Code ist absichtlich klein; fachliche Verfügbarkeit wird simuliert.

Tool-Schema: offer_search

{
  "name": "offer_search",
  "description": "Read-only search; returns non-binding offers",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": ["origin", "destination", "departureDate"],
    "properties": {
      "origin": {"$ref": "#/$defs/location"},
      "destination": {"$ref": "#/$defs/location"},
      "departureDate": {"type": "string", "format": "date"}
    },
    "additionalProperties": false,
    "$defs": {"location": {"type":"object","required":["scheme","code"],"properties":{"scheme":{"enum":["IATA","UIC","GTFS_STOP_ID"]},"code":{"type":"string","minLength":1}},"additionalProperties":false}}
  }
}

Das Beispiel trennt Ortskennung und Namensraum, verlangt ein Kalenderdatum und schließt unbekannte Eigenschaften aus. Eine vollständige Implementierung muss zusätzlich Zeitzonen, Servicekalender, Passagiertypen und Anbieterregeln berücksichtigen.

Strukturiertes Ergebnis und Provenienz

Ein Preis benötigt Betrag und Währung, aber auch Gültigkeit und Quelle. Das Ergebnis sollte klar sagen, ob es indikativ, revalidiert oder buchbar ist. Provenienzfelder sind eine redaktionelle Travel-Empfehlung, keine von MCP vorgeschriebenen Felder.

  • sourceSystem und retrievedAt für Herkunft
  • validUntil nur, wenn das Quellsystem eine belastbare Frist liefert
  • offerId als opaque identifier, nicht als fachlich zerlegbarer String
  • warnings für unvollständige Tarif- oder Barrierefreiheitsdaten

Negative Tests

Mindestens zu prüfen sind zusätzliche unbekannte Felder, ungültige Datumswerte, vertauschte oder identische Orte, nicht autorisierte Scopes, Timeout, Rate Limit, veraltete Angebote, doppelte Transaktionsaufrufe und bösartige Instruktionen in Tool-Ergebnissen.

Primärquellen und Spezifikationen