An MCP server for your oscilloscope

dho-mcp lets Claude, or any AI assistant that speaks the Model Context Protocol, drive a Rigol DHO or MHO: look at the screen, name the signals, measure with units and uncertainty, capture, decode and analyse, then tell you what it found. Every change it makes is reported and can be undone.

CH1What you can ask

"What's on the scope right now?"
"Measure CH2's rise time and check it against the datasheet's 5 ns."
"Why is my I²C bus failing?"
"Capture the UART on CH3 and show me the bytes after the reset."
"Is this clock's jitter good enough for 100 Mb/s?"

The assistant picks the tools, reads the answers, and explains them in plain language. You stay at the bench.

CH2The tools

Tool	What it does
`describe`	The model, its real limits, the image it runs and every current setting.
`identify`	Names what is on each channel: a square at 1 kHz, a sine, a UART at 115200 8N1, I²C, noise.
`measure`	Measurements with units, statistics and an uncertainty; optional pass, fail or marginal against limits you give.
`screenshot`	The screen as an image the assistant can look at.
`configure`	Channels, timebase, trigger and acquisition; every change is read back as old → requested → actual.
`capture`	A full record summarised: statistics, measurements, a small CSV, a thumbnail; the full record can be kept as evidence.
`decode`	Bus decodes and their event tables, including the NovaOS decoders.
`eye_jitter`	Eye diagram and jitter breakdown.
`generate`	Drives the built-in generator, only within the amplitude and offset limits the operator set.
`snapshot` · `restore`	Saves and puts back the scope's settings.
`autoscale` · `run` · `stop` · `single` · `query`	The basics, and read-only queries.

CH3Safe by design

No raw commands. The assistant never writes SCPI; settings come from a fixed table and are checked against the model's command set.
Refused outright: calibration, reset, factory, passwords, licences, firmware, and saving or loading files.
The generator stays off unless the operator starts the server with explicit limits, and it is switched on last, after the levels are read back inside them.
Read-only mode hides every tool that changes anything. An audit file can log every change.
Nothing new on the network: the server runs on your PC and talks to the scope over its existing SCPI port.

CH4On NovaOS, and on stock firmware

On a scope running NovaOS, the scope itself computes Identify, the eye and jitter, and the density rate. On a scope running Rigol's stock firmware, the server reads the waveform and runs the same analysis code on the PC, so most tools work there too.

Setup with Claude Code

claude mcp add dho -- dho-mcp --host <your-scope>
# add --read-only to look without touching anything,
# or --gen-max-vpp 2 to let it use the generator up to 2 Vpp

An example exchange

→ identify
← CH1 square 1 kHz, duty 50 %, 3.3 Vpp, rise 4 ns (0.97)
  CH2 sine 1 kHz, THD 0.1 % (0.95)
  CH3 UART 115200 8N1 (0.92)
→ measure CH1 Vpp, rise time, 4 readings, limit rise ≤ 5 ns
← Vpp 3.3 V · rise 4.1 ns ± 0.8 ns pass
→ configure CH1 scale 0.5 V/div
← 1.0 → 0.5 V/div, set · undo: restore

The example runs against the test suite's simulated scope. The server has been checked read-only on our own DHO924S; it is not available to download yet. Tell us if you want to try it: brady@aioscilloscope.com.