Aerospace MCP - Flight Planning API & MCP Server

A comprehensive aerospace research and flight planning service providing both HTTP API and Model Context Protocol (MCP) integration. Built with FastMCP for streamlined MCP server development. Features intelligent airport resolution, great-circle route calculation, aircraft performance estimation, atmospheric modeling, coordinate frame transformations, aerodynamic analysis, propeller performance modeling, rocket trajectory optimization, orbital mechanics calculations, and spacecraft trajectory planning for aerospace operations.

⚠️ SAFETY DISCLAIMER

THIS SOFTWARE IS FOR EDUCATIONAL, RESEARCH, AND DEVELOPMENT PURPOSES ONLY

• NOT FOR REAL NAVIGATION: Do not use for actual flight planning or navigation
• NOT CERTIFIED: This system is not certified by any aviation authority
• ESTIMATES ONLY: Performance calculations are theoretical estimates
• NO WEATHER DATA: Does not account for weather, NOTAMs, or airspace restrictions
• NO LIABILITY: Authors assume no responsibility for any consequences of use

For real flight planning, always use certified aviation software and consult official sources including NOTAMs, weather reports, and air traffic control.

🚀 Quick Start

The only prerequisite is uv, which also fetches Python 3.11+ if your system has none. Releases on PyPI ship prebuilt wheels for Linux (x86_64 and arm64, glibc 2.28+ and musl), macOS 11+ (Intel and Apple Silicon) and Windows x64, so no Rust toolchain or compiler is needed.

curl -LsSf https://astral.sh/uv/install.sh | sh   # Linux / macOS

Claude Code: MCP server + skills in one line

claude plugin marketplace add cheesejaguar/aerospace-mcp && claude plugin install aerospace-mcp@aerospace-mcp

Inside a session (Claude Code 2.1.275 or later) the same is /plugin install aerospace-mcp --marketplace cheesejaguar/aerospace-mcp. The plugin starts the MCP server with uvx aerospace-mcp and adds the skills in skills/. For the MCP server alone: claude mcp add aerospace -- uvx aerospace-mcp.

Skills for other agents (Cursor, Codex, OpenCode, ...)

npx skills add cheesejaguar/aerospace-mcp

The skills run tools through uvx --from aerospace-mcp aerospace-mcp-cli, so they need uv too (and Node.js for npx).

Claude Desktop and other MCP clients

{
  "mcpServers": {
    "aerospace": {
      "command": "uvx",
      "args": ["aerospace-mcp"]
    }
  }
}

GUI apps on macOS do not inherit your shell's PATH: if the client cannot find uvx, use the absolute path printed by which uvx (usually ~/.local/bin/uvx). The first launch downloads about 300 MB of dependencies; run uvx --from aerospace-mcp aerospace-mcp-cli list once beforehand so the client's server start-up timeout is not spent on the download.

CLI and HTTP API

uvx --from aerospace-mcp aerospace-mcp-cli run hohmann_transfer --r1_m 6778000 --r2_m 42164000
uvx --from aerospace-mcp aerospace-mcp-http        # http://localhost:8080/docs
uv tool install aerospace-mcp                      # all three commands on PATH

Optional extras work the same way, e.g. uvx --from 'aerospace-mcp[llm]' aerospace-mcp for the LLM agent tools (set LLM_TOOLS_ENABLED=true and OPENAI_API_KEY).

From source (development)

Building from a checkout compiles the native core, so it needs a Rust toolchain:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh   # Rust (rustup)
git clone https://github.com/cheesejaguar/aerospace-mcp.git
cd aerospace-mcp
uv sync                               # builds aerospace_mcp._native

cp .env.example .env                  # optional: host/port/log level, LLM tools
uv run aerospace-mcp                  # MCP server (stdio)
uv run aerospace-mcp sse 0.0.0.0 8001 # MCP server (SSE, debugging)
uv run aerospace-mcp-http             # HTTP API
uvicorn main:app --reload --port 8080 # HTTP API with auto-reload

Docker

git clone https://github.com/cheesejaguar/aerospace-mcp.git
cd aerospace-mcp
docker build -t aerospace-mcp .
docker run -p 8080:8080 aerospace-mcp

# Test the API
curl "http://localhost:8080/health"

📋 Table of Contents

• Features
• Installation
• Usage Examples
• Architecture
• FastMCP Migration
• Performance
• API Documentation
• MCP Integration
• Development
• Contributing
• License

✨ Features

Core Capabilities

• Airport Resolution: Intelligent city-to-airport mapping with 7,861 IATA airports worldwide
• Route Planning: Great-circle distance calculation with geodesic precision
• Performance Estimation: Aircraft-specific fuel and time calculations via OpenAP
• Atmospheric Modeling: ISA atmosphere profiles with optional enhanced precision
• Coordinate Transformations: ECEF, ECI, geodetic frame conversions for aerospace analysis
• Multiple Interfaces: HTTP REST API and Model Context Protocol (MCP) support
• Real-time Processing: Sub-second response times for flight planning requests

This is the beginning of the README. Read the rest at the original. Read the full README ↗