MCP Flight Search

🚀 Flight Search Based on MCP

A flight search service built using the Model Context Protocol (MCP). This project demonstrates how to implement MCP tools to support flight search functionality.

🚀 Quick Start

This project is a flight search service built with the Model Context Protocol (MCP). It showcases the implementation of MCP tools for flight search.

✨ Features

• A flight search tool compliant with the MCP standard.
• Integration with SerpAPI Google Flights.
• Support for one-way and round-trip flights.
• Extensive logging with structured output.
• A modular and easily maintainable code structure.

📦 Installation

# Install from PyPI
pip install mcp-flight-search

# Or install directly in development mode
pip install -e .

💻 Usage Examples

Basic Usage

Start the MCP server:

# Use the command-line entry point
mcp-flight-search --connection_type http

# Or run directly
python main.py --connection_type http

Advanced Usage

You can also specify a custom port:

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

📚 Documentation

Environment Variables

Set the SerpAPI key as an environment variable:

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

MCP Tools

This package provides the following Model Context Protocol tools:

• search_flights_tool: Search for flights between airports, with the following 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 (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 export
│   ├── config.py                # Configuration variables (API keys)
│   ├── models/
│   │   ├── __init__.py          # Model package initialization
│   │   └── schemas.py           # Pydantic models (FlightInfo)
│   ├── services/
│   │   ├── __init__.py          # Service package initialization
│   │   ├── search_service.py    # Main flight search logic
│   │   └── serpapi_client.py    # SerpAPI client wrapper
│   ├── utils/
│   │   ├── __init__.py          # Utility package initialization
│   │   └── logging.py           # Logging configuration
│   └── server.py                # MCP server setup and tool registration
├── main.py                      # Entry point
├── pyproject.toml               # Python packaging configuration
├── LICENSE                      # MIT License
└── README.md                    # Project documentation

Author

To learn more about AI/ML and generative AI articles, visit my Medium blog: https://medium.com/@arjun-prabhulal

📄 License

This project is released under the MIT License. For detailed information, please refer to the LICENSE file.