amadeus-mcp-server-standalone

Amadeus MCP Server

This is a Model Context Protocol (MCP) server that connects to the Amadeus API to provide flight search, booking, and analysis capabilities for AI assistants.

Features

• Flight Search: Find flights between airports with various parameters
• Airport Information: Search for airports by keyword, city, or country
• Price Analysis: Get price metrics for routes to determine if current prices are high or low
• Cheapest Dates: Find the most economical dates to travel
• Flight Details: Get detailed information about specific flight offers

Prompts

The server provides several pre-configured prompts for common travel planning scenarios:

1. Analyze Flight Prices: Analyze flight prices for a route with insights on pricing trends
2. Find Best Deals: Find the best flight deals for a specific route and date
3. Plan Multi-City Trip: Plan a complete multi-city itinerary with optimal routing
4. Find Cheapest Travel Dates: Identify the most economical dates to travel

Setup

Prerequisites

• Node.js 16.x or higher
• Amadeus API credentials (Client ID and Secret)

Installation

1. Clone the repository and navigate to the directory.

2. Install dependencies.

3. Create a .env file with Amadeus API credentials.

Running the Server

Build and start the server.

Testing and Development

This project uses Jest for testing and Biome for linting and formatting.

Integration Testing

Includes comprehensive integration tests for server interaction with Amadeus API.

Best Practices for Integration Testing

• API Rate Limits include automatic handling.
• Tests are designed to skip automatically if API credentials are missing.

Integration

To use this MCP server with OpenAI's Assistant API or compatible AI systems, configure the assistant to connect to this server's endpoint.

Tools

The server provides tools like search-flights, search-airports, flight-price-analysis, get-flight-details, and find-cheapest-dates.