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
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
以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗
