✈️ Flight MCP Server — SQLite Demo

このサーバーはPromise完全に機能する**Model Context Protocol（MCP）**のデモンストレーション・サーバーで、シミュレーションによるフライト検索・予約機能を提供します。

[!WARNING] シミュレーション専み: このシステム内のフライト、在庫、予約はすべて架空・サンプル・データによる完全なシミュレーションです。このプロジェクトは実際の航空会社APIとは連携しておらず、実際のフライトの予約を行うことはありません。

プロジェクトとは何か?

このプロジェクトは、Model Context Protocol（MCP）の基礎を理解するために作られた、コンパクトにまとめられたモジュール式Pythonアプリュです。Claude Desktopとシームレスー接続、安全かつ制限されたアクセスでローカルのSQLiteデータベースを参照し、デモ用のフライト検索・予約するバックエンド・サーバーです。

このプロジェクトは、Model Context Protocol (MCP)の基本を学ぶために設計された、クリーンでモジュールのみなPythonアプリであり、Claude Desktop之間にはーバーとして機能し、ローカルのSQLiteデータベースへのアクセスを安全で管理されたAIに提供して、デモ・フライトの検索・予約をします。

Related MCP server: SQLite MCP Server

MCPとは何か?

構簡UnitModel Context Protocol（MCP） は、AIモデル（例：Claude）がローカルまたはリモートのデータソース、ツール、およびサービスに安全に接続できるようにするオープンプロトコルです。LLMがデータを推測・記憶したり現実に並しないことをするのではなく、MCPは決定的なバックエンド・システムにクエリを送れます。

アーキテクチャ

システムのアーキテクチャは、Clean & クリーンな層構造を採りれています。

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

技術スタック

• 言語: Python 3.11+

• パッケージ管理者: uv

• **フレームワーク:**公式MCP Python SDK（mcp）

• データベース: SQLite（ローカルファイル）

• クラアント: Claude Desktop

利用可能な6つのツール

サーバーはAIに堅牢な6つのMCPツールを公開します。

1. search_flights: 出発地・到着地・日付で、利用可能なフライトを検索します。

2. get_flight: 特定フライトの詳細情報とメタデータを取得します。

3. check_seats: 座席の空席状況を取得します。

4. book_flight: 新しいシミュレーション予約を作成します（ユーザーの確認が必要）。

5. get_booking: PNRを参照して既存の予約詳細を取得します。

6. cancel_booking: 予約をキャンセルして、座席の在庫を復元します。

SQLite デモデータベース

このサーバーは、ローカルSQLiteデータベース（data/flightmcp.db）にフライト本数・予約状態を保存しています。 注記: 状態の古い問題を防ぐため、実際の .db ファイルは バージョン管理の対象外です。

新しいデータでデモデータを初期化するには、以下のコマンドを実行します:

uv run python scripts/seed_database.py

インストールとセットアップ

uv がインストールしてあることを確認し、依存関係を同期します:

uv sync

テストの実行

プロジェクトには、バックエンドの検証用の堅牢な pytest スイートが含まれています。

uv run pytest

MCPサーバーの起動

サーバーが正しく起動することを手動で確認します（サーバーはプロックして stdio 通信を待機します）:

uv run flight-mcp

（アプリケーションのログは stderr の出力専用であり、MCPプロトコルの出力を stdout でクリーンに保ちます。）

Claude Desktop の設定

このMCPサーバーをClaude Desktopに接続するには、Claude Desktop の構成ファイル（通常はmacOSのパス ~/Library/Application Support/Claude/claude_desktop_config.json）を編集してください。

Claude Desktop の設定例:

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

（パソースは、ローカル・プロジェクト・ディレクトリト uv のインストールパスに合わせて調整してください。）

ツールの利用例

Clade Desktopに接続すると、次の召に口径な対話でやりとりできます。

ユーザー: 「2026-09-05 にチェンナイからデリー行便（デリ）はありますか？」

• Claude が search_flights を呼ブ出ями、SQLite データべースを照会します。*

ユーザー: 「フライト1の空席は何席ですか？」

• Claude が check_seats を呼出します。*

ユーザー: 「便1を予約したいです。私はTest User、e-mailは test@example.com、電話は9999です。」 Claude が予約のコンテンに要約し、明示的に確認を求めます。

ユーザー: 「確認しました。」 Claude が book_flight を呼出し、架空の予約参照符（例：111-XXXXXX）を返します。