Skip to main content
Glama

✈️ IATA-Geo-Core: MCP Aviation Distance Engine

IATA-Geo-Core is a high-precision Model Context Protocol (MCP) server designed for aviation-specific geospatial calculations. It provides a reliable interface for AI agents to query airport information and calculate Great Circle distances between thousands of commercial airports globally using 3-letter IATA codes.


🌟 Key Features

  • FFP Industry Standard: Calculates distances in Statute Miles, the universal standard for Airline Frequent Flyer Program (FFP) accruals.

  • Curated Dataset: Powered by a refined database of 4,000+ active commercial airports (Large, Medium, and Scheduled Service hubs).

  • Precision Math: Implements the Haversine Formula for accurate spherical distance calculation.

  • MCP Native: Built to integrate seamlessly with Claude Desktop, Cursor, and other MCP-compatible AI environments.


Related MCP server: Claude Flight Search MCP Server

πŸ“‚ Project Structure

IATA-Geo-Core/
β”œβ”€β”€ data/               # Refined airport database (iata_geo_core.csv)
β”œβ”€β”€ scripts/            # Core logic (calculator.py, refine_data.py)
β”œβ”€β”€ mcp_server.py       # MCP Server entry point (STDIO transport)
└── README.md           # Documentation

πŸ› οΈ Installation & Data Setup

1. Initialize Environment

python3 -m venv .venv
source .venv/bin/activate
pip install mcp pandas

2. Generate Core Data

Run the refinement script to fetch and process the latest global airport data:

python3 scripts/refine_data.py

πŸš€ Claude Desktop Configuration

To enable these tools in Claude Desktop, add the following entry to your configuration file:

File Path: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "iata-geo-core": {
      "command": "/Users/<YOUR_USERNAME>/Documents/IATA-Geo-Core/.venv/bin/python3",
      "args": [
        "/Users/<YOUR_USERNAME>/Documents/IATA-Geo-Core/mcp_server.py"
      ],
      "env": {
        "PYTHONPATH": "/Users/<YOUR_USERNAME>/Documents/IATA-Geo-Core"
      }
    }
  }
}

πŸ”§ Tools Provided

get_airport_distance

Calculates the Great Circle distance between two airports.

  • Input: origin (e.g., "PEK"), destination (e.g., "JFK").

  • Returns: Distance in statute miles (float).

  • Example Query: "How many miles from London Heathrow to Singapore Changi?"


πŸ“ Technical Specifications

  • Algorithm: Haversine Formula.

  • Earth Radius ($r$): Using $3958.8$ miles (Mean radius).

  • Formula:

$$d = 2r \arcsin\left(\sqrt{\sin^2\left(\frac{\Delta\phi}{2}\right) + \cos\phi_1 \cos\phi_2 \sin^2\left(\frac{\Delta\lambda}{2}\right)}\right)$$


πŸ“œ License

MIT License. Created for the AeroAccrual Ecosystem.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables flight planning and aviation operations through intelligent airport resolution, great-circle route calculation, and aircraft performance estimation. Supports 28,000+ airports worldwide and 190+ aircraft types for comprehensive flight planning via natural language.
      46
      64 PyPI
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides AI assistants with access to real-time flight data, airport schedules, delays, and aviation reference databases through natural language queries.
      12
      189 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural-language and tool-based access to live flight status, airport departure/arrival boards, and scheduled flight timetables via the Cirium FlightStats Flex API.
      326 npm
      MIT