travel

The Travel MCP Server provides a set of tools to access travel-related data via the Model Context Protocol. It aggregates flight search and booking capabilities, hotel search, airport information, and real-time flight tracking by integrating Amadeus and AviationStack APIs. Tools available include search_flights for flight offers, search_hotels for hotel availability and pricing, search_airports for locating airports by city, find_cheapest_dates for discovering lower fare dates, track_flight for real-time status updates, get_flights_by_route to see all flights on a route, and get_airport_info to retrieve detailed airport data. You can interact with these tools through MCP-enabled clients or via Claude Desktop with a configured travel MCP server, enabling AI assistants to fetch travel data and surface it in natural language responses. When configuring Claude Desktop, your environment must provide Amadeus credentials and, optionally, AviationStack credentials if you want live tracking.

Prerequisites:

• Python 3.10+ installed
• pip available
• Access to Amadeus and AviationStack API credentials

Setup steps:

1. Clone the repository:

git clone https://your-repo-url.git
cd travel-mcp-server

2. Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the MCP package in editable mode:

pip install -e .

4. Copy example environment file and edit credentials:

cp .env.example .env

Edit the .env file to include your API keys (or set them in the environment):

AMADEUS_CLIENT_ID=your_amadeus_api_key_here
AMADEUS_CLIENT_SECRET=your_amadeus_api_secret_here
AMADEUS_ENV=test  # Use 'production' for live usage
AVIATIONSTACK_API_KEY=your_aviationstack_key_here

5. Run the server (example command):

python -m travel_mcp.server

6. Optional: configure Claude Desktop or other MCP clients with the provided travel server details.

Notes:

• Ensure network access to Amadeus and AviationStack endpoints.
• If you change credentials, restart the MCP server so the new keys are loaded.

Environment and configuration tips:

• The AviationStack API is optional but required for real-time flight tracking. If you don’t have a key, track_flight will be unavailable.
• Use AMADEUS_ENV set to 'test' during development and 'production' in production environments.
• For Claude Desktop integration, ensure the python path in the config points to your virtual environment's python executable and that the travel_mcp.server module is importable.
• If you encounter an 'Unknown tool' error, verify API keys are valid and that the MCP server has initialized the API clients successfully in the logs.
• Rate limits apply per API provider; plan accordingly for production workloads.