mcp-flight-search

Integrations

  • Integrates with SerpAPI Google Flights to search for flights between airports, supporting one-way and round-trip itineraries

A flight search service built with Model Context Protocol (MCP). This service demonstrates how to implement MCP tools for flight search capabilities.

What is Model Context Protocol?

The Model Context Protocol (MCP) is a standard developed by Anthropic that enables AI models to use tools by defining a structured format for tool descriptions, calls, and responses. This project implements MCP tools that can be used by Claude and other MCP-compatible models.

Installation

# Install from PyPI pip install mcp-flight-search # Or install from the project directory (development mode) pip install -e .

Usage

Start the MCP server:

# Using the command-line entry point mcp-flight-search --connection_type http # Or run directly python main.py --connection_type http

You can also specify a custom port:

python main.py --connection_type http --port 5000

Environment Variables

Set the SerpAPI key as an environment variable:

export SERP_API_KEY="your-api-key-here"

Features

  • MCP-compliant tools for flight search functionality
  • Integration with SerpAPI Google Flights
  • Support for one-way and round-trip flights
  • Rich logging with structured output
  • Modular, maintainable code structure

MCP Tools

This package provides the following Model Context Protocol tools:

  • search_flights_tool: Search for flights between airports with parameters:
    • origin: Departure airport code (e.g., ATL, JFK)
    • destination: Arrival airport code (e.g., LAX, ORD)
    • outbound_date: Departure date (YYYY-MM-DD)
    • return_date: Optional return date for round trips (YYYY-MM-DD)
  • server_status: Check if the MCP server is running

Project Structure

mcp-flight-search/ ├── mcp_flight_search/ │ ├── __init__.py # Package initialization and exports │ ├── config.py # Configuration variables (API keys) │ ├── models/ │ │ ├── __init__.py # Models package init │ │ └── schemas.py # Pydantic models (FlightInfo) │ ├── services/ │ │ ├── __init__.py # Services package init │ │ ├── search_service.py # Main flight search logic │ │ └── serpapi_client.py # SerpAPI client wrapper │ ├── utils/ │ │ ├── __init__.py # Utils package init │ │ └── logging.py # Logging configuration │ └── server.py # MCP server setup and tool registration ├── main.py # Main entry point ├── pyproject.toml # Python packaging configuration ├── LICENSE # MIT License └── README.md # Project documentation

Author

For more articles on AI/ML and Generative AI, follow me on Medium: https://medium.com/@arjun-prabhulal

License

This project is licensed under the MIT License - see the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol Server search realtime flight detail with multiple fligh carrier, price , stop , time duration for any given date using simple prompt

  1. What is Model Context Protocol?
    1. Installation
      1. Usage
        1. Environment Variables
          1. Features
            1. MCP Tools
              1. Project Structure
                1. Author
                  1. License

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.
                      Last updated -
                      8
                      10
                      Python
                      MIT License
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates with Brave Search API to provide real-time search capabilities through Server-Sent Events (SSE).
                      Last updated -
                      TypeScript
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.
                      Last updated -
                      3
                      0
                      2
                      JavaScript
                      MIT License
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server that provides real-time access to Hong Kong's KMB and Long Win Bus route information and arrival times, enabling Language Models to answer user questions about bus routes, stops, and ETAs.
                      Last updated -
                      3
                      Python
                      • Linux
                      • Apple

                    View all related MCP servers

                    ID: hday0oprmu