Flightticketmcp

🚀 Flight Ticket MCP Server

A flight ticket query server based on the Model Context Protocol (MCP), providing standardized interfaces for real-time flight dynamic queries to AI assistants.

🚀 Quick Start

The Flight Ticket MCP Server serves as a bridge between AI assistants and aviation service systems, offering standardized interfaces for real-time flight dynamic queries.

✨ Features

Real-time Flight Dynamic Query

• Query detailed flight information by flight number and date.
• Get real-time flight dynamics and status information.
• Display codeshare flight numbers.
• Obtain flight schedules and aircraft type information.
• Retrieve airport and terminal information.
• Check on-time performance statistics.
• Find check-in counter and boarding gate information.
• Get meal and baggage check-in information.
• Access weather forecasts.
• Obtain contact phone information.

Flight Route Query

• Query available flights by departure city, destination city, and departure date.
• Support 282 domestic cities and airport codes.
• Provide intelligent city name parsing (supporting city names, airport codes, and full formats).
• Get real-time flight prices and schedules.
• Obtain airline and aircraft type information.
• Retrieve terminal and boarding gate information.
• Analyze price statistics and airline distribution.
• Format query results for output.

🔧 Technical Details

Core Modules (Core)

• Flight data processing.

Tool Modules (Tools)

• Real-time flight dynamic query tools.

Utility Tools (Utils)

• Data validation and formatting.
• Date and time processing.
• API client encapsulation.

Supported Transport Protocols

This server supports three transport protocols:

1. sse - Server-Sent Events (default, suitable for web applications).
2. stdio - Standard input/output (suitable for Claude Desktop).
3. streamable-http - Streamable HTTP (suitable for HTTP clients).

📦 Installation

Prerequisites

• Python 3.11 or higher.
• pip package manager.

Basic Installation

# Clone or download the project
cd FlightTicketMCPServer

# Install dependencies
pip install -r requirements.txt

💻 Usage Examples

Configuration with Claude Desktop

1. After installation, add the server to the Claude Desktop configuration file:

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "sse",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000"
      }
    }
  }
}

2. Configuration file location:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Restart Claude Desktop to load the configuration.

Configuration for Different Transport Protocols

SSE Mode (Default)

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "sse",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000",
        "MCP_SSE_PATH": "/sse"
      }
    }
  }
}

stdio Mode

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

HTTP Mode

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "python",
      "args": ["D:\\FlightTicketMCPServer\\flight_ticket_server.py"],
      "env": {
        "MCP_TRANSPORT": "streamable-http",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000",
        "MCP_PATH": "/mcp"
      }
    }
  }
}

Example Operations

After configuration, you can ask Claude to perform the following operations:

Real-time Flight Dynamic Query

• "Query the real-time dynamics of flight CA3401 on June 12, 2024."
• "Query the detailed information of flight MU5678 today."
• "Check the departure time and terminal information of flight CZ1234 tomorrow."

Flight Route Query

• "Query flights from Chongqing to Guangzhou tomorrow."
• "Search for all flights from Shanghai to Beijing the day after tomorrow."
• "Check the flight prices from Shenzhen to Chengdu on July 20, 2024."
• "What are the flight options from Beijing to Sanya?"

📚 Documentation

API Reference

Real-time Flight Dynamic Query

searchFlightsByNumber(fnum, date)  # Query detailed flight information and real-time dynamics by flight number and date

Input parameters:

• fnum: Flight number (e.g., CA3401).
• date: Flight departure date (in YYYY-MM-DD format).

Output information:

• Flight number and codeshare flight numbers.
• Operating airline.
• Departure and arrival airports and terminals.
• Departure and arrival times.
• Aircraft type and flight duration.
• Flight distance and on-time performance.
• Check-in counter and boarding gate.
• Meal and baggage check-in information.
• Weather forecast.
• Contact phone number.

Flight Route Query

searchFlightRoutes(departure_city, destination_city, departure_date)  # Query available flights by departure city, destination city, and date

Input parameters:

• departure_city: Name of the departure city or airport code (e.g., "Chongqing", "CKG", "Chongqing(CKG)").
• destination_city: Name of the destination city or airport code (e.g., "Guangzhou", "CAN", "Guangzhou(CAN)").
• departure_date: Departure date (in YYYY-MM-DD format).

Output information:

• Flight list (including flight number, airline, departure and arrival times, airport, terminal, price).
• Price statistics (minimum, maximum, average).
• Airline distribution statistics.
• Formatted query results output.
• Supported cities: 282 domestic cities and airports.

Supported city formats:

• City names: Shanghai, Beijing, Chongqing, Guangzhou, etc.
• Airport codes: SHA, BJS, CKG, CAN, etc.
• Full formats: Shanghai(SHA), Beijing(BJS), etc.

Development

Project Structure

FlightTicketMCPServer/
├── flight_ticket_server/
│   ├── core/              # Core business logic
│   ├── tools/             # MCP tool implementation
│   ├── utils/             # Utility functions
│   └── main.py            # Server entry point
├── office_flight_ticket_server/  # Additional modules
├── tests/                 # Test files
├── logs/                  # Log file directory
├── pyproject.toml         # Project configuration
├── requirements.txt       # Project dependencies
├── flight_ticket_server.py # Main startup file
├── mcp-config.json        # MCP configuration example
└── README.md              # Project documentation

Testing

# Run all tests
python -m pytest tests/ -v

# Run basic function tests
python -m pytest tests/test_basic.py -v

# Run specific tests
python -m pytest tests/test_basic.py::TestFlightSearch::test_searchFlightsByNumber -v

Logging and Debugging

• Log file location: logs/ directory.
• Enable debug mode: Set MCP_DEBUG=true.
• View real-time logs: tail -f logs/flight_server.log.

Troubleshooting

Common Issues

1. Port is occupied

   # Change the port
   set MCP_PORT=8001
   python flight_ticket_server.py
   

2. Import errors

   # Ensure you are in the correct directory
   cd FlightTicketMCPServer/flight_ticket_server
   python flight_ticket_server.py
   

3. Permission issues

   # Check file permissions
   ls -la flight_ticket_server.py
   chmod +x flight_ticket_server.py
   

Log Analysis

View log files to understand detailed error information:

# View general logs
cat logs/flight_server.log

# View error logs
cat logs/flight_server_error.log

# Monitor logs in real-time
tail -f logs/flight_server.log

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🤝 Contribution

We welcome you to submit issues and pull requests to improve this project.

🛠️ Support

If you encounter any issues or have feature suggestions, please create an issue on GitHub.