SimBrief MCP Server

Ein Model Context Protocol-Server, der Claude Desktop direkten Zugriff auf Ihre SimBrief-Flugpläne gewährt – kein Cloudflare, kein OAuth, keine Infrastruktur erforderlich.

Funktionen

14 Tools, die jeden Abschnitt eines SimBrief-OFP abdecken:

Alle Tools akzeptieren einen optionalen plan_id-Parameter – lassen Sie ihn leer, um immer Ihren neuesten Flugplan abzurufen.

Related MCP server: SimBrief Flight Planning MCP Server

Anforderungen

• Python 3.11+

• uv

• Ein SimBrief-Konto (kostenlos)

Installation

git clone https://github.com/Emanuele94/SimBrief-MCPServer.git
cd SimBrief-MCPServer
uv sync

Konfiguration

Ihre SimBrief Pilot ID wird über eine Umgebungsvariable in der MCP-Konfiguration übergeben – keine Codeänderungen erforderlich.

Sie finden Ihre Pilot ID unter SimBrief → Account Settings → Pilot ID.

Claude Desktop-Integration

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "simbrief": {
      "command": "uv",
      "args": [
        "run",
        "--project", "/absolute/path/to/SimBrief-MCPServer",
        "python",
        "/absolute/path/to/SimBrief-MCPServer/server.py"
      ],
      "env": {
        "SIMBRIEF_PILOT_ID": "your_pilot_id_here"
      }
    }
  }
}

Starten Sie anschließend Claude Desktop neu. Die SimBrief-Tools erscheinen automatisch.

Der Server verweigert den Start mit einer klaren Fehlermeldung, wenn SIMBRIEF_PILOT_ID nicht gesetzt ist.

Anwendungsbeispiele

Sobald die Verbindung hergestellt ist, können Sie Claude Dinge fragen wie:

• "Was ist mein neuester Flugplan?"

• "Zeig mir das Wetter für meinen nächsten Flug."

• "Wie viel Treibstoff ist geplant und wie sieht die Aufschlüsselung aus?"

• "Gib mir den vollständigen ATC-Flugplan-String."

• "Was passiert mit dem Treibstoffverbrauch, wenn ich 2000 Fuß tiefer fliege?"

• "Zeig mir die ersten 20 Wegpunkte meines Navlogs."

Entwicklung

Entwicklungsabhängigkeiten installieren:

uv sync --all-extras

Tests ausführen:

uv run pytest -v

Linting und Formatierung:

uv run ruff check .
uv run ruff format .

Alle Tests laufen vollständig offline – die SimBrief-API wird gemockt, sodass keine Internetverbindung oder eine echte Pilot ID erforderlich ist.

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/my-feature)

3. Nehmen Sie Ihre Änderungen vor und fügen Sie Tests hinzu

4. Stellen Sie sicher, dass die CI-Pipeline lokal erfolgreich durchläuft (uv run pytest && uv run ruff check .)

5. Öffnen Sie einen Pull Request gegen main

PRs müssen alle Prüfungen (Tests + Lint) bestehen, bevor sie zusammengeführt werden können.

Lizenz

MIT