mcp-flight-tracker/README.md

Advanced MCP server for flight tracking with live landmark detection

# MCP Flight Tracker

Advanced Model Context Protocol (MCP) server for comprehensive flight tracking with live landmark detection and real-time location updates.

## 🚀 Features

- **Live Flight Search** - Real-time flight search with pricing and schedules
- **Flight Status Tracking** - Comprehensive flight status with gates, delays, and aircraft info
- **Live Flight Tracking** - Real-time GPS tracking with landmark detection
- **Active Flight Discovery** - Find currently flying aircraft with live tracking
- **Airport Information** - Detailed airport data and information
- **Dynamic Landmark Detection** - Live landmark discovery using OpenStreetMap
- **Passenger-Friendly Messages** - "Flying near Taj Mahal" style updates

## 📦 Installation

```bash
npx mcp-flight-tracker
```

## 🔧 Setup

1. Get API keys:
   - [SerpAPI](https://serpapi.com/) for flight search
   - [AviationStack](https://aviationstack.com/) for flight status and tracking

2. Create a `.env` file:
```env
SERP_API_KEY=your_serpapi_key
AVIATIONSTACK_API_KEY=your_aviationstack_key
```

## 🛠️ Available Tools

### search_flights
Search for flights between airports with live pricing
- `origin`: Origin airport code (e.g., JFK)
- `destination`: Destination airport code (e.g., LAX)  
- `date`: Departure date (YYYY-MM-DD)
- `passengers`: Number of passengers (optional, default: 1)
- `class_type`: Travel class (optional, default: economy)

### flight_status
Get comprehensive real-time flight status
- `flight_number`: Flight number (e.g., DL1)

### track_flight
Track live flight location with landmark detection
- `flight_number`: Flight number (e.g., DL1)

### find_active_flights
Find currently active flights with live tracking
- `limit`: Number of flights to return (optional, default: 10)

### airport_info
Get detailed airport information
- `code`: Airport IATA code (e.g., JFK)

## 🎯 Usage with Claude Desktop

Add to your Claude Desktop config:

```json
{
  "mcpServers": {
    "flight-tracker": {
      "command": "npx",
      "args": ["mcp-flight-tracker"],
      "env": {
        "SERP_API_KEY": "your_serpapi_key",
        "AVIATIONSTACK_API_KEY": "your_aviationstack_key"
      }
    }
  }
}
```

## 💬 Example Conversations

- "Search for flights from JFK to LAX on 2024-02-15"
- "Track flight DL1 and tell me what landmarks it's flying over"
- "What's the status of flight AA123?"
- "Find 5 active flights that have live tracking"
- "Tell me about JFK airport"

## 🌍 Global Coverage

- ✅ **Worldwide flight data** - All major airlines and airports
- ✅ **Indian flights** - IndiGo (6E), Air India (AI), SpiceJet (SG)
- ✅ **US flights** - Delta (DL), American (AA), United (UA)
- ✅ **European flights** - Lufthansa (LH), British Airways (BA)
- ✅ **Live landmark detection** - Famous monuments, tourist attractions
- ✅ **Real-time location updates** - GPS coordinates and altitude

## 🔄 Live Data Sources

- **SerpAPI** - Live flight search and pricing
- **AviationStack** - Real-time flight tracking and status
- **OpenStreetMap Nominatim** - Dynamic landmark discovery
- **Reverse Geocoding** - Country and region identification

## 📝 License

MIT

## 🤝 Contributing

Issues and pull requests welcome!