ctrltest-mcp

License: MIT Python

Reusable control-system regression utilities for Model Context Protocol services. It evaluates PID gains against a second-order plant, computes gust-rejection metrics, and blends optional diffSPH/Foam-Agent metrics supplied by the caller.

Features

Deterministic PID step response analysis (overshoot, settling time, ISE).
Optional gust detector, adaptive CPG, and MoE router scoring primitives.
FastAPI app + python-sdk helper ready for MCP deployments.

Installation

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

Usage

from ctrltest_mcp import ControlAnalysisInput, ControlPlant, ControlSimulation, PIDGains from ctrltest_mcp import evaluate_control inputs = ControlAnalysisInput( plant=ControlPlant(natural_frequency_hz=5.0, damping_ratio=0.6, settling_tolerance_rad=0.02, trim_setpoint=0.0), simulation=ControlSimulation(duration_s=5.0, sample_points=500), gains=PIDGains(kp=0.8, ki=0.05, kd=0.02), ) metrics = evaluate_control(inputs) print(metrics["overshoot"])

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?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables control system analysis and testing through PID controller evaluation against second-order plants. Provides regression testing utilities with step response analysis, gust rejection metrics, and settling time calculations for control engineering applications.

CtrlTest MCP Server