✈️ Flight MCP Server — SQLite Demo

Полнофункциональный демонстрационный сервер на базе Model Context Protocol (McP), предоставляющий симулированные возможностьи поиска рейсов и бронирования.

[!WARNING] ТОЛЬКО СИМУЛЯЦИЯ: Все рейсы, наличие мест и бронирования в этой системе полностью симулированы на основе вымышленных/демонстрационных данных. Этот проект НЕ интегрируется с реальными API авиакомпаний и НЕ бронирует реальные рейсы.

Что это за проект?

Этот проект — чистая и модульная и модульная, на Python-приложение, разработанное для изучения основных Model Context Protocol (McP). Он работает как локальный бэкенд-сервер, который бесшовно подключается к Claude Desktop, предоставляет ИИ безопасный и контролируемый доступ к локальной базе данных SQLite для поиска и бронирования демонстрационных рейсов.

Related MCP server: SQLite MCP Server

Что такое MCP?

Model Context Protocol (McP) — это открытый стандарт, позволяющий ИИ-моделям (например, Claude) безопано подключаться к локальным или удалённым источникам данных. Вместо того, чтобы LLМ угадывал или галлюцировал данные, McP позволяет ей выполнять запросы к детерминированной бэкенд-системе.

Архи тектура

Архитектура системы построена по чистой послеонной многоуровнем scheme:

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

Технологический стек

• Язык: Python 3.11+

• Менежер пакетов: uv

• Фреймворк: Официальный McP PythonSDK (mcp)

• База данных: SQLite (локальный файл)

• Клиент: Claude Desktop

Шесть доступных инструментов

Сервер предоставляет ИИ ровно шесть надежных инструментов 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, чтобы preservestdout был выход MCP-протокола чистым.)

Настройка Claude Desktop

Чтобы подключить этот MCP-сервер к Claude Desktop, fromредактируйте файл конфигурации 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"
    }
  }
}

(Примечание: скорректируйте абсолютные пути в соответсвии с локаальным каталогом вашего проекта и путьом installи uv.)

Примеры использования инструментов

После подключения к Claude Desktop вы можете общаться природическим яз àзыком:

Пользователь: «Найди мне рейс из Ченнаяй в Дели на 2026-09-05.» Claude вызывает search_flights and работает с базой данных SQLite.

Пользователь: «Сколько мест осталось на рейсе 1?» Claude вызывает check_seats.

Пользователь: «Я хочу бронировать рейс. Меня зовут Test User, email — test@example.com, телефон — 9999999999.» Claude кратко резюмирует запрос and просит явного подтверждения.

Пользователь: «Подтверждаю.» Claude вызывает book_flight and возвращает вымышленный код брони (например, FLM-XXXXXX).