Information
# 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:
\`\`\`bash
pip install mcp fast-flights
\`\`\`
## Usage
### Running the Server
You can run the server directly:
\`\`\`bash
python flight_planner_server.py
\`\`\`
### Integrating with Claude Desktop
1. Install [Claude Desktop](https://claude.ai/download)
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:
\`\`\`json
\{
"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:
\`\`\`bash
# 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