Flight Planner MCP Server

A Model Context Protocol server that creates travel agent-level flight plans using the fast-flights API.

Features

• Search for one-way and round-trip flights
• Create comprehensive travel plans based on trip parameters
• Get airport code information
• Use templates for common travel queries

Installation

1. Make sure you have Python 3.10 or higher installed
2. Install the required packages:

pip install mcp fast-flights

Usage

Running the Server

You can run the server directly:

python flight_planner_server.py

Integrating with Claude Desktop

1. Install Claude Desktop

2. Create or edit your Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%Claudeclaude_desktop_config.json

3. Add the flight-planner server configuration:

{
  "mcpServers": {
    "flight-planner": {
      "command": "python",
      "args": [
        "/PATH/TO/flight_planner_server.py"
      ],
      "env": {
        "PYTHONPATH": "/PATH/TO/PROJECT"
      }
    }
  }
}

4. Replace /PATH/TO/ with the actual path to your server file
5. Restart Claude Desktop

Using the MCP Inspector

For testing and development, you can use the MCP Inspector:

# Install the inspector
npm install -g @modelcontextprotocol/inspector

# Run the inspector with your server
npx @modelcontextprotocol/inspector python flight_planner_server.py

Available Tools

• search_one_way_flights: Search for one-way flights between airports
• search_round_trip_flights: Search for round-trip flights between airports
• create_travel_plan: Generate a comprehensive travel plan

Available Resources

• airport_codes://{query}: Get airport code information based on a search query

Available Prompts

• flight_search_prompt: Template for searching flights
• travel_plan_prompt: Template for creating a comprehensive travel plan

Example Queries for Claude

Once integrated with Claude Desktop, you can ask things like:

• “What flights are available from NYC to SFO on 2025-04-15?”
• “Can you create a travel plan for my business trip from LAX to TPE from 2025-05-01 to 2025-05-08?”
• “Help me find airport codes for Tokyo.”
• “What’s the best time to book flights from Boston to London for a summer vacation?”

License

MIT