A Model Context Protocol server that creates travel agent-level flight plans using the fast-flights API
Project description
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
- Make sure you have Python 3.10 or higher installed
- 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
-
Install Claude Desktop
-
Create or edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the flight-planner server configuration:
{
"mcpServers": {
"flight-planner": {
"command": "python",
"args": [
"/PATH/TO/flight_planner_server.py"
],
"env": {
"PYTHONPATH": "/PATH/TO/PROJECT"
}
}
}
}
- Replace
/PATH/TO/with the actual path to your server file - 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 airportssearch_round_trip_flights: Search for round-trip flights between airportscreate_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 flightstravel_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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iflow_mcp_google_flights_mcp-0.1.0.tar.gz.
File metadata
- Download URL: iflow_mcp_google_flights_mcp-0.1.0.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb8dfa81a14cb10c5323a53abb0f6bda7692375b6fcf43569d16e99ef455d371
|
|
| MD5 |
d01c80a0a09810c578cd7862be58065a
|
|
| BLAKE2b-256 |
c5ee33eaca054c953f797c818abfdbfef66f10b40878919624976315abd55152
|
File details
Details for the file iflow_mcp_google_flights_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: iflow_mcp_google_flights_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 8.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4eb181e309693a1a693eef6159f1a778ce8d99c29ce949b81c96105f52ae501d
|
|
| MD5 |
72817e536b0bd9de6fef459ef9fc0712
|
|
| BLAKE2b-256 |
8921d8d6c2e8ce77ad18f3ba8ac09275a3b9dcedbde025307e35c076610b8b46
|