pterasim-mcp
Reusable Pterasim integration for Model Context Protocol services. It exposes typed request/response models, a FastAPI surface, and an analytic fallback when the native pterasim module is unavailable.
Features
simulatehelper that callspterasim.simulate_wingwhen installed, otherwise returns a lift/drag/thrust estimate.FastAPI app factory (
create_app) for HTTP deployments.python-sdk tool registration helper for STDIO-based agents.
Installation
pip install "git+https://github.com/yevheniikravchuk/pterasim-mcp.git"
Usage
from pterasim_mcp import PterasimInput, simulate_pterasim
inputs = PterasimInput(
span_m=0.8,
mean_chord_m=0.12,
stroke_frequency_hz=6.0,
stroke_amplitude_rad=0.35,
cruise_velocity_m_s=8.0,
air_density_kg_m3=1.2,
cl_alpha_per_rad=5.7,
cd0=0.02,
planform_area_m2=0.18,
tail_moment_arm_m=0.25,
)
output = simulate_pterasim(inputs)
print(output.thrust_N)
Development
uv pip install --system -e .[dev]
uv run ruff check .
uv run pytest
License
MIT — see LICENSE.
This server cannot be installed
Enables wing simulation and aerodynamic analysis for pterosaur-inspired flight models. Provides lift, drag, and thrust calculations through the pterasim module with analytical fallbacks when the native module is unavailable.