openvsp-mcp

License: MIT Python

Model Context Protocol tooling for automating OpenVSP geometry edits and VSPAero runs. The package delivers reusable Pydantic models, a FastAPI surface, and python-sdk integration hooks so teams can embed OpenVSP in their own agents without inheriting Orthodrone-specific assumptions.

Features

Declarative request/response models for geometry edits and optional VSPAero sweeps.
Subprocess helpers that write .vspscript automation files and invoke vsp / vspaero binaries.
FastAPI app factory and python-sdk tool registration helper.
100% MIT-licensed and covered by unit tests.

Installation

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

Quickstart (FastAPI)

from openvsp_mcp.fastapi_app import create_app app = create_app()

Launch locally:

uv run uvicorn openvsp_mcp.fastapi_app:create_app --factory --host 127.0.0.1 --port 8002

Quickstart (python-sdk tool)

from mcp.server.fastmcp import FastMCP from openvsp_mcp.tool import build_tool app = FastMCP("openvsp-mcp", "OpenVSP automation") build_tool(app) if __name__ == "__main__": app.run()

Example STDIO session

uv run mcp dev examples/openvsp_tool.py

Send a JSON request:

{ "tool": "openvsp-mcp.vsp", "arguments": { "geometry_file": "models/demo.vsp3", "set_commands": [{ "command": "vsp_set wing Span 0.5" }], "run_vspaero": true, "case_name": "hover" } }

Environment variables

OPENVSP_BIN (default vsp)
VSPAERO_BIN (default vspaero)

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 automated geometry editing and aerodynamic analysis using OpenVSP and VSPAero through natural language. Provides tools to modify aircraft geometry parameters and run computational fluid dynamics simulations programmatically.

OpenVSP MCP Server