Specification · section A
reference implementation
openmhp is a Python implementation of everything above (PyYAML is the only dependency, for device packages): the Driver base class with all gates and detail tiers, the device package loader, the live-pinging Directory, stdio and HTTP+SSE transports, the lazy Lab client SDK, the mhp CLI (including serve-directory), the eight-tool mhp-mcp bridge over stdio or HTTP, BoundDriver and the five ecosystem adapters, three Agent Skills (bundled in the package, mhp skills install), the fleet and mhp_lab, network discovery, the npx openmhp-cli launcher, two simulated devices, adapter tests that run against injected fakes, and the 2,000-device scale demo. Writing a new driver is a descriptor plus three hooks (on_read, on_write, on_invoke), with optional validate_params and on_fault. See README.md.
Status: experimental. Everything is tested against simulators and fakes; no physical instrument or vendor system has been exercised. §16 lists what is not yet specified.