📌Overview

Purpose: To provide an integration of Amadeus flight search capabilities into the Claude Desktop framework.

Overview: The Amadeus MCP Server enables users to leverage Amadeus' comprehensive flight search functionalities seamlessly within the Claude environment. By utilizing FastMCP for server implementation, it supports efficient async operations and offers robust log management.

Key Features:

Flight Search Functionality: Allows users to search for flights using IATA codes for origin and destination, alongside a specified travel date. This feature enhances travel planning by providing real-time flight availability.
Logging and Debugging Tools: Includes comprehensive logging mechanisms to track errors and system performance, as well as built-in debugging steps to assist in resolving common issues efficiently.

Amadeus MCP Server

This MCP server integrates Amadeus flight search capabilities with Claude Desktop.

Setup

Environment Variables

Create a .env file with the following content:

AMADEUS_API_KEY=your_key
AMADEUS_API_SECRET=your_secret

Claude Desktop Configuration

Configure Claude Desktop with the following JSON structure:

{
  "mcpServers": {
    "amadeus": {
      "command": "python",
      "args": ["path/to/amadeus/server.py"],
      "env": {
        "AMADEUS_API_KEY": "your_key",
        "AMADEUS_API_SECRET": "your_secret",
        "PYTHONPATH": "path/to/amadeus"
      }
    }
  }
}

Available Tools

Search Flights

Parameters

origin: IATA airport code
destination: IATA airport code
date: YYYY-MM-DD format

Troubleshooting

Common Issues

Connection Timeouts
- Check server.py logs in amadeus_mcp.log
- Verify environment variables
- Review Claude Desktop logs
Authentication Errors
- Verify Amadeus API credentials
- Check .env file permissions

Debugging Steps

Run a standalone test:

npx @modelcontextprotocol/inspector python path/to/server.py

Check logs:
```
tail -f amadeus_mcp.log
```

Verify environment:

python -c "import os; print(os.getenv('AMADEUS_API_KEY'))"

Architecture Notes

Utilizes FastMCP for server implementation
Implements stdio transport
Logs to both stderr and file
Handles asynchronous flight search operations

amadeus-mcp