Google航班MCP工具

Or install dependencies first, then run directly

pip install pydantic curl_cffi httpx python examples/python/basic_one_way_search.py ```

Available Examples:

• basic_one_way_search.py - Simple one-way flight search
• round_trip_search.py - Round-trip flight booking
• date_range_search.py - Find cheapest dates
• multi_city_search.py - Multi-city itinerary across several legs
• advanced_filters_search.py - Alliances, airline exclusions, layovers, locale
• complex_flight_search.py - Advanced filtering and multi-passenger
• time_restrictions_search.py - Time-based filtering
• date_search_with_preferences.py - Weekend filtering
• price_tracking.py - Price monitoring over time
• error_handling_with_retries.py - Robust error handling
• result_processing.py - Data analysis with pandas
• complex_round_trip_validation.py - Advanced round-trip with validation
• advanced_date_search_validation.py - Complex date search with filtering

Install dependencies with uv

uv sync --all-extras

Install using pipx (recommended for CLI)

pipx install flights

TypeScript (from examples/typescript, after `bun install`)

bun run multi_city_search.ts ```

Example Categories:

• Basic Usage: One-way, round-trip, date searches
• Advanced Filtering: Time restrictions, airlines, alliances, seat classes, locale
• Data Analysis: Price tracking, result processing with pandas
• Error Handling: Retry logic, robust error management
• Complex Scenarios: Multi-city, multi-passenger, validation, business rules

Each example is self-contained — change the airports, dates, and filters at the top of the script to fit your search.

Build documentation

uv run mkdocs serve

Docker Development

```bash

Build the devcontainer

docker build -t fli-dev -f .devcontainer/Dockerfile .

Or run CI inside Docker (no local act installation needed)

make ci-docker ```

Quick Start

pip install flights

```bash

CLI Usage

Python API Usage

Basic Search Example

```python from datetime import datetime, timedelta from fli.models import ( Airport, PassengerInfo, SeatType, MaxStops, SortBy, FlightSearchFilters, FlightSegment ) from fli.search import SearchFlights

Running Examples

Runnable examples live in examples/python/:

```bash

Run examples with uv (recommended)

uv run python examples/python/basic_one_way_search.py uv run python examples/python/round_trip_search.py uv run python examples/python/date_range_search.py

Examples

Examples are organized by language, with parallel scripts so you can compare the two APIs:

• Python — examples/python/
• TypeScript — examples/typescript/

```bash

CLI Options

Flights Command (fli flights)

Dates Command (fli dates)

Multi Command (fli multi)

Claude Desktop Configuration

To use the flight search capabilities in Claude Desktop, add this configuration to your claude_desktop_config.json:

Location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "flight-search": {
      "command": "fli-mcp",
      "args": []
    }
  }
}

After adding this configuration:

1. Restart Claude Desktop 2. You can now ask Claude to search for flights naturally: "Find flights from JFK to LAX on December 25th" "What are the cheapest dates to fly from NYC to London in January?" * "Search for business class flights from SFO to NRT with no stops"

MCP Server Integration

Fli includes a Model Context Protocol (MCP) server that allows AI assistants like Claude to search for flights directly. This enables natural language flight search through conversation.