✈️ Flight MCP Server — SQLite-Demo

Ein voll funktionsfähiger Model Context Protocol (MCP)-emonstrationserver, der simulierten Flugsuche und Buchungsfunktionen bietet.

[!WARNING] NUR SIMULATION: Alle Flüge, Bestände und Buchungen in diesem System sind vollständig simuliert und verwenden erfundene bzw. Beispieldaten. Dieses Projekt integriert keine echten Airline-APIs und bucht keine echten Flüge.

Was ist das Projekt?

Dieses Projekt ist eine saubere, modulare Python-Anwendung, die dazu dient, die Grundlagen desModel Context Protocol (MCP) zu vermitteln. Sie fungiert als lokaler Backend-Server, der sich nahtlos mit Claude Desktop verbindet und der KI sicheren, kontrollierten Zugriff auf eine lokale SQLate-Datenbank gewährt, um Demo-Flüge zu suchen und zu buchen.

Related MCP server: SQLite MCP Server

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Modellen (wie Claude) ermöglicht, sich sicher mit lokalen oder entfernten Datenquellen, Tools und Diensten zu verbinden. Anstatt dass das LLM Daten errät oder halluziniert, kann es über MCP ein deterministisches Backend-System abfragen.

Architektur

Die Systemarchitektur folgt einem sauberen, geschichteten Aufbau:

Claude Desktop (Client)
        ↓ (stdio JSON-RPC)
Python Flight MCP Server
        ↓
Services Layer (Business Logic)
        ↓
SQLite Database (Data Store)

Technologie-Stack

• Sprache: Python 3.11+

• Paketmanager: uv

• Framework: Offizielles MCP-Python-SDK (mcp)

• Datenbank: SQLite (lokale Datei)

• Client: Claude Desktop

Sechs verfügbare Tools

Der Server stellt der KI genau sechs robuste MCP-Tools zur Verfügung:

1. search_flights: Finde verfügbare Flüge nach Abflugort, Ziel und Datum.

2. get_flight: Rufe vollständige Details und Metadaten für eine bestimmten Flug ab.

3. check_seats: Prüfe die aktuelle Sitzverfügbarkeit für eine Flug.

4. book_flight: Erstellt eine neuesimulierte Buchung (erfordert Benutzerbestätigung).

5. get_booking: Rufe Details zu einer bestehenden Buchung über eine PNR-Referenz ab.

6. cancel_booking: Storne eine Buchung und stelle das Sitzkontingent wieder her.

SQLite-Demo-Datenbank

Das System verwendet eine lokale SQLite-Datenbank (data/flightmcp.db), um Flugbestände und Buchungszustände zu speichern. Hinweis: Die eigentliche .db- Datei ist von der Versionsveraltung ausgeschlossen, um Probleme durch veraltete Zustände zu vermeiden.

Um die Datenbank mit frischen Demo-Daten zu initialisieren, führen Sie folgenden Befehl aus:

uv run python scripts/seed_database.py

Installation & Einrichtung

Stellen Sie sicher, dass uv installiert ist, und synchronisieren Sie dann die Abhängigkeiten:

uv sync

Ausführen der Tests

Das Projkt enthält ein robustes pytest-Program für die Backend-Verifizierung.

uv run pytest

Ausführen des MCP-Servers

Um manuell zu prüfung, dass der Server korrekt startet (er blockiert und wartet auf die stdio-ommunikation):

uv run flight-mcp

(Anwendungslogs werden strikt nach stderr geleitet, um eine saubere MCP-Protokoll-Ausgabe auf stdout zu gewährleisten.)

Konfiguration von Claude Desktop

Um diesen MCP-Server mit Claude Desktop zu verbinden, bearten Sie theConfigurationsdatei von Claude Desktop (normalerweise unter ~/Library/Application Support/Claude/claude_desktop_config.json auf mac**).

Beispiel für die Claude-Desktop-Konfiguration:

{
  "mcpServers": {
    "flight-mcp": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/baratharjun/Desktop/medai",
        "flight-mcp"
      ],
      "cwd": "/Users/baratharjun/Desktop/medai"
    }
  }
}

Hinweis: Passen Sie die absoluten Pfade so an, dass sie Ihrem lokalen Projektverzeichnis und Ihrem uv-Installationspfad passen.

Beispiel für die Tool-Nutzung

Sobald Sie in Claude Desktop verbunden sind, können Sie autürich agieren:

Benutzer: "Finde einen Flug von Chennai nach Delhi am 2026-09-05." Claude ruft search_flights auf und liest die SQLite-Datenbank.

Benutzer: "Wie viele Sitzplätze sind auf Flug 1 noch frei?" Claude ruft check_seats auf.

Benutzer: "I möchte Flug 1 buchen. Mein Name ist Test User, die E-Mail ist test@example.comund, Telefon 9999999999." Claude fasst die Anfrage zusammen und bittet ausdrücklich um Bestätigung.

Benutzer: "Bestätigt." Claude ruft book_flight auf und gibt die fictive Buchungsreferenz zurück (z. B. FLM-XXXXXX).