# Flight Tracker MCP Server
A Model Context Protocol (MCP) server that provides comprehensive flight tracking capabilities using the OpenSky Network API.
## Features
- **Real-time Flight Tracking**: Get live flight data for aircraft overhead any location
- **Geographic Searches**: Query flights within bounding boxes or radius searches
- **Historical Data**: Access flight histories for specific aircraft or airports
- **Airport Operations**: Track arrivals and departures at specific airports
- **Flight Paths**: Get detailed flight tracks with position history
- **Authentication Support**: Optional authentication for enhanced data access
## Installation
```bash
pip install flight-tracker-mcp
```
## Usage
### Basic MCP Server Setup
```python
from flight_tracker_mcp import main
import asyncio
# Run the MCP server
if __name__ == "__main__":
asyncio.run(main())
```
### Available Tools
#### 1. Get Overhead Flights
Get flights currently overhead a specific location:
```json
{
"name": "get_overhead_flights",
"arguments": {
"latitude": 40.7128,
"longitude": -74.0060,
"radius_km": 10
}
}
```
#### 2. Get States in Bounding Box
Query flights within a geographic area:
```json
{
"name": "get_states_in_bbox",
"arguments": {
"min_lat": 40.0,
"max_lat": 41.0,
"min_lon": -75.0,
"max_lon": -73.0
}
}
```
#### 3. Get Airport Arrivals
Track arrivals at a specific airport:
```json
{
"name": "get_airport_arrivals",
"arguments": {
"airport": "KJFK",
"start_time": 1640995200,
"end_time": 1641081600
}
}
```
#### 4. Get Aircraft Track
Get the flight path of a specific aircraft:
```json
{
"name": "get_aircraft_track",
"arguments": {
"icao24": "a1b2c3",
"timestamp": 0
}
}
```
### Authentication (Optional)
For enhanced data access, you can provide OpenSky Network credentials:
```python
from flight_tracker_mcp import FlightTracker
# With authentication
tracker = FlightTracker(username="your_username", password="your_password")
# Without authentication (limited to public data)
tracker = FlightTracker()
```
## MCP Integration
This server integrates with MCP-compatible clients like Claude Desktop. Add to your MCP configuration:
```json
{
"mcpServers": {
"flight-tracker": {
"command": "python",
"args": ["-m", "flight_tracker_mcp"]
}
}
}
```
## API Reference
All tools return JSON-formatted flight data with the following common fields:
- `icao24`: Aircraft identifier
- `callsign`: Flight callsign
- `latitude`/`longitude`: Position coordinates
- `geo_altitude_m`: Altitude in meters
- `velocity_mps`: Speed in meters per second
- `heading`: True track heading
- `last_contact`: Timestamp of last position update
## Requirements
- Python >= 3.8
- OpenSky Network API access (free registration recommended)
- MCP-compatible client
## Data Source
This package uses the [OpenSky Network](https://opensky-network.org/) API, which provides real-time and historical flight data from a global network of ADS-B receivers.
## License
MIT License - see LICENSE file for details.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Support
If you encounter any issues or have questions, please open an issue on the GitHub repository.
Raw data
{
"_id": null,
"home_page": "https://github.com/GenAICPA/flight_tracker",
"name": "flight-tracker-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, flight, tracking, aviation, opensky",
"author": "Eric",
"author_email": "your-email@example.com",
"download_url": "https://files.pythonhosted.org/packages/30/1d/4454ff13e80cb8bf7f990a11563c50061aaa593baa59b5fa4d922af9aac5/flight_tracker_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# Flight Tracker MCP Server\n\nA Model Context Protocol (MCP) server that provides comprehensive flight tracking capabilities using the OpenSky Network API.\n\n## Features\n\n- **Real-time Flight Tracking**: Get live flight data for aircraft overhead any location\n- **Geographic Searches**: Query flights within bounding boxes or radius searches\n- **Historical Data**: Access flight histories for specific aircraft or airports\n- **Airport Operations**: Track arrivals and departures at specific airports\n- **Flight Paths**: Get detailed flight tracks with position history\n- **Authentication Support**: Optional authentication for enhanced data access\n\n## Installation\n\n```bash\npip install flight-tracker-mcp\n```\n\n## Usage\n\n### Basic MCP Server Setup\n\n```python\nfrom flight_tracker_mcp import main\nimport asyncio\n\n# Run the MCP server\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n### Available Tools\n\n#### 1. Get Overhead Flights\nGet flights currently overhead a specific location:\n\n```json\n{\n \"name\": \"get_overhead_flights\",\n \"arguments\": {\n \"latitude\": 40.7128,\n \"longitude\": -74.0060,\n \"radius_km\": 10\n }\n}\n```\n\n#### 2. Get States in Bounding Box\nQuery flights within a geographic area:\n\n```json\n{\n \"name\": \"get_states_in_bbox\",\n \"arguments\": {\n \"min_lat\": 40.0,\n \"max_lat\": 41.0,\n \"min_lon\": -75.0,\n \"max_lon\": -73.0\n }\n}\n```\n\n#### 3. Get Airport Arrivals\nTrack arrivals at a specific airport:\n\n```json\n{\n \"name\": \"get_airport_arrivals\",\n \"arguments\": {\n \"airport\": \"KJFK\",\n \"start_time\": 1640995200,\n \"end_time\": 1641081600\n }\n}\n```\n\n#### 4. Get Aircraft Track\nGet the flight path of a specific aircraft:\n\n```json\n{\n \"name\": \"get_aircraft_track\",\n \"arguments\": {\n \"icao24\": \"a1b2c3\",\n \"timestamp\": 0\n }\n}\n```\n\n### Authentication (Optional)\n\nFor enhanced data access, you can provide OpenSky Network credentials:\n\n```python\nfrom flight_tracker_mcp import FlightTracker\n\n# With authentication\ntracker = FlightTracker(username=\"your_username\", password=\"your_password\")\n\n# Without authentication (limited to public data)\ntracker = FlightTracker()\n```\n\n## MCP Integration\n\nThis server integrates with MCP-compatible clients like Claude Desktop. Add to your MCP configuration:\n\n```json\n{\n \"mcpServers\": {\n \"flight-tracker\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"flight_tracker_mcp\"]\n }\n }\n}\n```\n\n## API Reference\n\nAll tools return JSON-formatted flight data with the following common fields:\n\n- `icao24`: Aircraft identifier\n- `callsign`: Flight callsign\n- `latitude`/`longitude`: Position coordinates\n- `geo_altitude_m`: Altitude in meters\n- `velocity_mps`: Speed in meters per second\n- `heading`: True track heading\n- `last_contact`: Timestamp of last position update\n\n## Requirements\n\n- Python >= 3.8\n- OpenSky Network API access (free registration recommended)\n- MCP-compatible client\n\n## Data Source\n\nThis package uses the [OpenSky Network](https://opensky-network.org/) API, which provides real-time and historical flight data from a global network of ADS-B receivers.\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nIf you encounter any issues or have questions, please open an issue on the GitHub repository.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP Server for flight tracking using OpenSky Network API",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/GenAICPA/flight_tracker",
"Issues": "https://github.com/GenAICPA/flight_tracker/issues",
"Repository": "https://github.com/GenAICPA/flight_tracker"
},
"split_keywords": [
"mcp",
" flight",
" tracking",
" aviation",
" opensky"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "88a46b23333c24cae96007486f46616bf9eaf78fe00bb4d46d3895aa7aa35184",
"md5": "07914feb91dfc0cf6cdbf92abb2d6d30",
"sha256": "7dfa9dd89e18836c5a4b468c3b1478ef14e8bae8181be645c651b9ceba328935"
},
"downloads": -1,
"filename": "flight_tracker_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "07914feb91dfc0cf6cdbf92abb2d6d30",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7619,
"upload_time": "2025-07-23T00:38:13",
"upload_time_iso_8601": "2025-07-23T00:38:13.904128Z",
"url": "https://files.pythonhosted.org/packages/88/a4/6b23333c24cae96007486f46616bf9eaf78fe00bb4d46d3895aa7aa35184/flight_tracker_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "301d4454ff13e80cb8bf7f990a11563c50061aaa593baa59b5fa4d922af9aac5",
"md5": "882c50231262e4df0b6def0308e21598",
"sha256": "1fb3c5caed1711d2348b23012798e30d56a75b6cfc3d616835bb6dc1859bcb54"
},
"downloads": -1,
"filename": "flight_tracker_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "882c50231262e4df0b6def0308e21598",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7314,
"upload_time": "2025-07-23T00:38:15",
"upload_time_iso_8601": "2025-07-23T00:38:15.205141Z",
"url": "https://files.pythonhosted.org/packages/30/1d/4454ff13e80cb8bf7f990a11563c50061aaa593baa59b5fa4d922af9aac5/flight_tracker_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 00:38:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GenAICPA",
"github_project": "flight_tracker",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "mcp",
"specs": [
[
">=",
"1.11.0"
]
]
},
{
"name": "opensky-api",
"specs": [
[
">=",
"1.3.0"
]
]
},
{
"name": "aiohttp",
"specs": [
[
">=",
"3.8.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.0"
]
]
}
],
"lcname": "flight-tracker-mcp"
}
JSON
