Flight Planner MCP Server

1# Flight Planner MCP Server
2 
3A Model Context Protocol server that creates travel agent-level flight plans using the fast-flights API.
4 
5## Features
6 
7- Search for one-way and round-trip flights
8- Create comprehensive travel plans based on trip parameters
9- Get airport code information
10- Use templates for common travel queries
11 
12## Installation
13 
141. Make sure you have Python 3.10 or higher installed
152. Install the required packages:
16 
17```bash
18pip install mcp fast-flights
19```
20 
21## Usage
22 
23### Running the Server
24 
25You can run the server directly:
26 
27```bash
28python flight_planner_server.py
29```
30 
31### Integrating with Claude Desktop
32 
331. Install [Claude Desktop](https://claude.ai/download)
342. Create or edit your Claude Desktop configuration file:
35   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
36   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
37 
383. Add the flight-planner server configuration:
39 
40```json
41{
42  "mcpServers": {
43    "flight-planner": {
44      "command": "python",
45      "args": [
46        "/PATH/TO/flight_planner_server.py"
47      ],
48      "env": {
49        "PYTHONPATH": "/PATH/TO/PROJECT"
50      }
51    }
52  }
53}
54```
55 
564. Replace `/PATH/TO/` with the actual path to your server file
575. Restart Claude Desktop
58 
59### Using the MCP Inspector
60 
61For testing and development, you can use the MCP Inspector:
62 
63```bash
64# Install the inspector
65npm install -g @modelcontextprotocol/inspector
66 
67# Run the inspector with your server
68npx @modelcontextprotocol/inspector python flight_planner_server.py
69```
70 
71## Available Tools
72 
73- `search_one_way_flights`: Search for one-way flights between airports
74- `search_round_trip_flights`: Search for round-trip flights between airports  
75- `create_travel_plan`: Generate a comprehensive travel plan
76 
77## Available Resources
78 
79- `airport_codes://{query}`: Get airport code information based on a search query
80 
81## Available Prompts
82 
83- `flight_search_prompt`: Template for searching flights
84- `travel_plan_prompt`: Template for creating a comprehensive travel plan
85 
86## Example Queries for Claude
87 
88Once integrated with Claude Desktop, you can ask things like:
89 
90- "What flights are available from NYC to SFO on 2025-04-15?"
91- "Can you create a travel plan for my business trip from LAX to TPE from 2025-05-01 to 2025-05-08?"
92- "Help me find airport codes for Tokyo."
93- "What's the best time to book flights from Boston to London for a summer vacation?"
94 
95## License
96 
97MIT
98