MCP Flight Search
@arjunprabhulal
MCP Server implementation for the Model Context Protocol (MCP) enabling AI tool usage - Realtime Flight Search
Overview
What is MCP Flight Search?
MCP Flight Search is a flight search server built with the Model Context Protocol (MCP). It integrates with SerpAPI Google Flights to provide one-way and round-trip flight search tools that can be used by Claude and other MCP‑compatible AI models. It is intended for developers who want to enable flight‑search capabilities in their MCP‑based agents.
How to use MCP Flight Search?
Install the package via pip install mcp-flight-search, then set the SERP_API_KEY environment variable. Start the server with mcp-flight-search --connection_type http (or python main.py --connection_type http). Optionally specify a custom port with --port. The server exposes two MCP tools: search_flights_tool (for flight searches) and server_status (to check the server’s health).
Key features of MCP Flight Search
- MCP‑compliant tools for flight search
- Integration with SerpAPI Google Flights
- Support for one‑way and round‑trip flights
- Rich logging with structured output
- Modular, maintainable code structure
- Configurable HTTP transport and port
Use cases of MCP Flight Search
- Enable an AI assistant to search for flights in real time
- Build a travel‑planning chatbot that can look up one‑way or round‑trip options
- Check the health of a flight search server before making requests
- Integrate flight data into a custom MCP‑based workflow
FAQ from MCP Flight Search
What is Model Context Protocol (MCP)?
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.
How do I install MCP Flight Search?
You can install it from PyPI with pip install mcp-flight-search, or install in development mode from the project directory with pip install -e ..
How do I set up the required API key?
Set the SerpAPI key as an environment variable: export SERP_API_KEY="your-api-key-here".
What tools does MCP Flight Search provide?
Two tools are available: search_flights_tool (parameters: origin, destination, outbound_date, optional return_date) and server_status (no parameters) to check if the server is running.
How do I start the server and change the port?
Start with mcp-flight-search --connection_type http or python main.py --connection_type http. To use a custom port, add --port 5000 (or your preferred port). The server uses HTTP transport.