Flight Planner

Create detailed flight plans using the fast-flights API.

GitHub

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%\Claude\claude_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"
      }
    }
  }
}
  1. Replace /PATH/TO/ with the actual path to your server file
  2. 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

관련 서버