xfoil-mcp

License: MIT Python

Domain-neutral Model Context Protocol (MCP) toolkit for running XFOIL polar analyses from agents or automation scripts. The package bundles reusable Pydantic models, an MCP-ready FastAPI server, and a python-sdk tool factory so you can embed XFOIL in your own workflows without inheriting any Orthodrone-specific schema.

Features

Typed request/response models for polar sweeps.
Reusable compute_polar helper that streams commands to the XFOIL CLI.
Optional FastAPI app and python-sdk tool shims for quick integration.
MIT-licensed, fully typed, and covered by unit tests.

Installation

pip install "git+https://github.com/yevheniikravchuk/xfoil-mcp.git"

PyPI publication is on the roadmap; until then install directly from the Git repository or vendor the package.

Quickstart (FastAPI)

from xfoil_mcp.fastapi_app import create_app app = create_app()

Run locally:

uv run uvicorn xfoil_mcp.fastapi_app:create_app --factory --host 127.0.0.1 --port 8001

Quickstart (python-sdk tool)

from mcp.server.fastmcp import FastMCP from xfoil_mcp.tool import build_tool mcp = FastMCP("xfoil-mcp", "XFOIL polar analysis") build_tool(mcp) if __name__ == "__main__": mcp.run()

Launch via STDIO transport:

uv run mcp dev examples/xfoil_tool.py

Environment

Set XFOIL_BIN to the path of your XFOIL executable if it is not already on PATH.

Local development

uv pip install --system -e .[dev] uv run ruff check . uv run pytest

License

MIT — see LICENSE.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables aerodynamic analysis through XFOIL polar computations. Provides typed models and tools to run airfoil performance analyses from agents or automation workflows.

XFOIL MCP Server