v0.3.0-alpha.2

• Validate configuration roots, shared component contracts and typed MCP inputs consistently; separate workspace, solver and optional BAT54 readiness.

• Accept the measured official uSimmics 5.9 Windows version-probe exit convention without accepting unrelated error exits.

• Validate full datasets and sample axes, reject nonfinite or mismatched results, and preserve provenance across interrupted publication.

• Add responsive, cancellable solver execution and session-scoped background jobs; checkpoint partial sweeps and verify resume data.

• Package discoverable circuit templates and provide config-free example commands. The MCP server now exposes 21 tools.

• Add clean installed-wheel checks and locked/latest-compatible dependency CI on Windows/Linux and Python 3.11/3.12.

• Preview redesign: anti-aliased symbols, one spectrum panel per node voltage instead of stems drawn over each other, round-number frequency ticks with automatic Hz/kHz/MHz/GHz units, and a power axis that grows instead of clipping above 20 dBm.

• Spectral lines are labelled with their mixing product (f1−f2), frequency and level; the labelled values are returned as spectrum_markers. Samples under the display floor are no longer drawn as dots on the floor.

• Net labels are drawn as tags with a leader to their node, colour-matched to their spectrum panel. Colliding labels are nudged clear (adjusted_labels). The HB block shows its tones and order. Diode and filter symbols follow their Schottky/Zener style and pass band. CJK file names use a CJK font.

• Stale or unverified datasets are flagged inside the image, not only in warnings.

Validation: 140 local tests passed (including native Windows/uSimmics tests); clean installed-wheel CLI/MCP smoke passed. Portable CI covers Windows/Linux and Python 3.11/3.12, plus latest-compatible dependencies.

Install the attached wheel with uv tool install --force <wheel-path>. uSimmics 5.9 must be installed separately. This remains an Alpha scoped to the verified HB subset, not arbitrary native application features.

v0.3.0-alpha.1

uSimmics MCP Bridge — first public Alpha

A local stdio MCP server for the verified uSimmics 5.9 harmonic-balance subset.

Included

• 16 tools for environment checks, project creation, complete-file saves/clones, structured circuit building, validation, previews, simulation, result publication and parameter comparisons.
• Portable Python package with configure/doctor commands and MCP client fallback.
• Cooperative writer locks, backups and stale-result detection.
• Bounded parameter sweeps with independent variants and JSON/CSV output.
• Original examples, English/Chinese documentation and MIT license.

Verification

• 30 local tests passed, including five native uSimmics cases for divider, RC/RL responses, Vdc schema, BAT54 mixing and parameter sweep behavior.
• Clean wheel installation passed the configure → build → simulate → preview → publish → sweep workflow.
• GitHub CI passed Windows/Linux × Python 3.11/3.12 for portable tests, protocol checks and packaging.

Installation

Install the wheel with uv tool install <downloaded-wheel-path> or install from this repository. Then run usimmics-bridge configure --installation-root <uSimmics-root> --project-root <project-root> and usimmics-bridge doctor.

uSimmics must be installed separately. Native execution is supported on Windows with version 5.9; the simulator and vendor model libraries are not bundled. This Alpha does not support arbitrary native components, markers/other diagram types, DC/AC/SP/transient analysis, or unsaved GUI buffers. Previews use the bridge renderer rather than native screenshots. See README for scope and known limitations.