Universal Delta HMI Agent

Portable, file-only MCP tools for Delta HMI engineering. DOP-B/DOPSoft 2 and DOP-100/DIAScreen run in separate backend processes, Python environments, profile registries, workspaces and job state. Original code is licensed under Apache-2.0.

This release integrates the existing qualified offline capabilities of two independent components. It preserves unknown native bytes, requires explicit target/source/plan contracts, and saves new candidates. It does not claim support for every model, driver or native widget. See support before choosing a task.

Install

Download and extract the complete offline ZIP from Releases. Windows x64 (PowerShell and the system tar command):

powershell.exe -NoProfile -ExecutionPolicy Bypass -File ./scripts/bootstrap.ps1 -Offline
./.venv/Scripts/python.exe -m delta_hmi.cli doctor --config .local/gateway.json
./.venv/Scripts/python.exe -m delta_hmi.cli config --config .local/gateway.json

Linux x86_64 with glibc:

sh scripts/bootstrap.sh
./.venv/bin/python -m delta_hmi.cli doctor --config .local/gateway.json
./.venv/bin/python -m delta_hmi.cli config --config .local/gateway.json

The package contains pinned CPython runtimes and dependency wheels. No Python, vendor IDE or administrator installation is required for the offline package. A source checkout can download only the release bundle specified by URL and SHA-256 in templates/releases.lock.json. Pass an explicit archive to either bootstrap script for fully offline source installation.

The Windows launch option applies only to that installer process and does not change the machine execution policy. The final command prints the MCP client configuration for this host. Copy its output into your MCP client. Paths are generated locally; virtual environments must be rebuilt when moving to another machine. Installation refuses to replace an existing environment.

Related MCP server: beyondcompare-mcp

Use

Call delta_catalog to see actual backend availability and authority. Tool names have explicit family prefixes:

• dop_b__: nine file tools and five persistent job tools. Jobs require a separately configured trusted policy; discovery never starts the queue.

• dop_100__: all 30 audited file tools and legacy aliases, plus close_session. Each opened project receives its own process and gateway session handle.

For DOP-B, call capabilities(profile_id), then open_project(profile_id, source_path). Follow the returned session/plan hashes through proposal, preview, validation, approval, application, new-only save and diff.

For DIAScreen, call open_project(profile_id, path, source_sha256) with a reviewed host profile. The gateway injects its pinned profile object and canonical hash. Pass the returned session_id to project tools. Review the exact proposed plan_sha256 using preview and validate before apply_plan; approval must match that digest. save_as requires the exact candidate hash. Close idle sessions explicitly.

The installed synthetic profiles exercise file framing only; they are not usable machine applications or vendor-qualified targets. New machine work requires an authorized native source/donor and a source-qualified model/editor/profile, addresses, types and behavior contract. Agent start and workflow describe the gates.

Scope and evidence

The repository includes source snapshots in components/dop_b and components/dop_100; implementations, policies and support evidence stay isolated. Component pins record provenance. No private native projects, customer PLC symbols, logos, fonts or machine logic are included.

File tests and synthetic previews establish offline behavior. Vendor opening, compilation, pixel fidelity, transport freshness, press/release behavior and physical panel operation require separate human acceptance. No Computer Use, vendor process or control-target connection is supplied.

The support ledger explicitly distinguishes implemented operations, source-bound limits, preserved-only resources, contract-only interfaces, withdrawn experiments and unsupported features. A passing refusal test is not a support claim. Alarm history, arbitrary picture-bank constructors and additional upstream widgets are not silently advertised as implemented.

Development

python tools/ci.py install
python tools/ci.py test

CI tests the gateway and both original component suites on Windows and Linux. Integration qualification uses scripts/probe_both.py against a clean installed configuration. Test receipts and independent review identify the actual reviewed scope.

• Architecture, workflow, goals

• Feature migration, regressions

• Support, persistent jobs

• Contributing, security, licensing

Apache-2.0 provides the contributor patent grant described in section 3. Third-party dependencies and runtimes retain their own licenses and notices. Delta product names describe compatibility targets; this is independent software without vendor endorsement.