Flight

Provides real-time flight data via Amadeus API for flight search, airport info, status, and airline data through MCP.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "technicalerikchan-flight-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "flight_mcp_server.server"
      ],
      "env": {
        "AMADEUS_API_KEY": "YOUR_API_KEY",
        "AMADEUS_API_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

You run a Flight MCP Server to query real-time flight data via the Amadeus API and serve it through the Model Context Protocol to Claude Desktop. It provides flight search, airport information, flight status, and airline details with a graceful fallback to mock data if the API is unavailable, so you can build responsive flight-enabled experiences in your client application.

How to use

You connect to the Flight MCP Server from an MCP client to perform practical actions like searching for flights, checking airport details, and querying flight status. Use the server to issue these capabilities as callable tools from your client interface: search flights between two airports, get airport information by IATA code, retrieve real-time flight status, and fetch airline information. If the external API cannot be reached, the server automatically falls back to mock data so your workflow remains uninterrupted.

To start using it, ensure the server is running and your MCP client is configured to connect to the local MCP endpoint. Once connected, begin with a simple flight search, for example: search for flights from one airport to another on a chosen date, then progressively add filters such as travel class and number of passengers. You can also check the status of a specific flight or retrieve airline and airport information as needed.

How to install

Prerequisites: Python 3.10 or newer and Amadeus API credentials.

Step 1: Clone the project repository.

git clone https://github.com/technicalerikchan/flight-mcp-server.git

Step 2: Change into the project directory.

cd flight-mcp-server

Step 3: Install dependencies.

pip install -r requirements.txt

Step 4: Prepare environment variables.

cp .env.example .env

Then add your Amadeus API credentials to the .env file with these keys:

AMADEUS_API_KEY=your_actual_api_key_here
AMADEUS_API_SECRET=your_actual_api_secret_here

Additional notes and configuration

Run the server locally using Python to start the MCP server process.

python -m flight_mcp_server.server

Available tools

search_flights

Search for flights between airports with parameters for origin, destination, departure date, return date, number of adults, and travel class.

get_airport_info

Retrieve detailed information for an airport given its IATA code.

get_flight_status

Check real-time status and delays for a specific flight using flight number and date.

get_airline_info

Fetch information about an airline using its IATA airline code.