MCP cover image
See in Github
2025-04-06

This MCP server provides tools to interact with Google Flights data using the bundled fast_flights library.

1

Github Watches

0

Github Forks

0

Github Stars

Google Flights MCP Server

This MCP server provides tools to interact with Google Flights data using the bundled fast_flights library.

Features

Provides the following MCP tools:

  • get_flights_on_date: Fetches available one-way flights for a specific date between two airports.
    • Args: origin (str), destination (str), date (str, YYYY-MM-DD), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).
  • get_round_trip_flights: Fetches available round-trip flights for specific departure and return dates.
    • Args: origin (str), destination (str), departure_date (str, YYYY-MM-DD), return_date (str, YYYY-MM-DD), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).
  • find_all_flights_in_range: Finds available round-trip flights within a specified date range. Can optionally return only the cheapest flight found for each date pair.
    • Args: origin (str), destination (str), start_date_str (str, YYYY-MM-DD), end_date_str (str, YYYY-MM-DD), min_stay_days (int, optional), max_stay_days (int, optional), adults (int, optional), seat_type (str, optional), return_cheapest_only (bool, optional, default False).

Setup

  1. Clone the repository:
    git clone https://github.com/opspawn/Google-Flights-MCP-Server.git
    cd Google-Flights-MCP-Server
    
  2. Create a virtual environment (recommended):
    python -m venv .venv
    source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
    
  3. Install dependencies:
    pip install -r requirements.txt
    
  4. Install Playwright browsers (needed by fast_flights):
    playwright install
    

Running the Server

You can run the server directly using Python:

python server.py

The server uses STDIO transport by default.

Integrating with MCP Clients (e.g., Cline, Claude Desktop)

Add the server to your MCP client's configuration file. Example for cline_mcp_settings.json or claude_desktop_config.json:

{
  "mcpServers": {
    "google-flights": {
      "command": "/path/to/your/.venv/bin/python", // Use absolute path to venv python
      "args": [
        "/absolute/path/to/flight_mcp_server/server.py" // Use absolute path to server script
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
    // ... other servers
  }
}

Important: Replace the paths in command and args with the absolute paths to your virtual environment's Python executable and the server.py script on your system.

Notes

  • This server bundles the fast_flights library (originally from https://github.com/AWeirdDev/flights) for its core flight scraping functionality. Please refer to the included LICENSE file for its terms.
  • Flight scraping can sometimes be unreliable or slow depending on Google Flights changes and network conditions. The tools include basic error handling.
  • The find_all_flights_in_range tool can be resource-intensive as it checks many date combinations.

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • Lists Tailwind CSS classes in monospaced font

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

  • n8n-io
  • Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.

    Reviews

    5 (1)
    Avatar
    user_A6XhHb7L
    2025-04-18

    I've been using the Google-Flights-MCP-Server by opspawn and it has exceeded my expectations. The server is reliable, efficient, and highly customizable, making it perfect for integrating flight data into my applications. With clear documentation and robust performance, it's an essential tool for any MCP application user. Highly recommended!