Simbrief Mcp Server

SimBrief MCP Server

Model Context Protocol サーバーです。Claude Desktop から SimBrief のフライトプランに直接アクセスできます。Cloudflare、OAuth、インフラストラクチャは不要です。

機能

SimBrief OFP のすべてのセクションを網羅する 14 個のツールを提供します。

ツール	説明
get_flight_summary	フライト番号、航空機、ルート、距離、巡航、ETE、燃料
get_weather	出発地、到着地、代替空港の METAR、TAF、ATIS
get_fuel_plan	燃料の詳細な内訳：タキシー、区間、予備、代替空港、予備燃料、追加燃料
get_weights	OEW、ペイロード、ZFW、TOW、ランプ重量、着陸重量
get_times	予定時刻の OUT/OFF/ON/IN、ETE、ブロックタイム、タキシー、航続時間
get_atc_flightplan	提出可能な形式の ATC フライトプラン文字列
get_aircraft_info	機種、登録番号、エンジン、装備コード
get_navlog	各区間の高度、距離、燃料を含む全ウェイポイント一覧
get_notams	すべての NOTAM（出発地、到着地、経路上）
get_alternate_info	代替空港の詳細とナビゲーションログ
get_performance	離着陸性能（TLR）。利用可能な場合
get_crew	機長、副操縦士、ディスパッチャー、パーサー、客室乗務員
get_impacts	高度やコストインデックスの変化による燃料と時間への影響
get_full_flight_plan	カスタム分析用の完全な生 JSON

すべてのツールで plan_id パラメーターは任意です。空欄にすると、常に最新のディスパッチ情報を取得します。

要件

• Python 3.11+
• uv
• SimBrief アカウント（無料）

インストール

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

設定

SimBrief の Pilot ID は MCP 設定の環境変数で渡します。コードを変更する必要はありません。

SimBrief → Account Settings → Pilot ID で Pilot ID を確認してください。

Claude Desktop との連携

次の内容を claude_desktop_config.json に追加してください。

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"
      }
    }
  }
}

その後、Claude Desktop を再起動してください。SimBrief ツールが自動的に表示されます。

SIMBRIEF_PILOT_ID が設定されていない場合、明確なエラーメッセージを表示してサーバーの起動を拒否します。

使用例

接続したら、Claude に次のような質問ができます。

• 「最新のフライトプランを教えて」
• 「次のフライトの天気を見せて」
• 「計画上の燃料量と内訳を教えて」
• 「ATC フライトプランの完全な文字列を教えて」
• 「高度を 2000 ft 下げて飛行した場合、燃料消費はどうなる？」
• 「ナビゲーションログの最初の 20 個のウェイポイントを見せて」

開発

開発用の依存関係をインストールします。

uv sync --all-extras

テストを実行します。

uv run pytest -v

Lint とフォーマットを実行します。

uv run ruff check .
uv run ruff format .

すべてのテストは完全にオフラインで実行できます。SimBrief API はモックされるため、インターネット接続も実際の Pilot ID も必要ありません。

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/my-feature）
3. 変更を加え、テストを追加します
4. CI パイプラインがローカルでパスすることを確認します（uv run pytest && uv run ruff check .）
5. main に対する Pull Request を作成します

PR がマージされるには、すべてのチェック（テストと lint）に合格する必要があります。

ライセンス

MIT