Skip to main content
Glama
nk-dho924s-mcp

nk-dho924s-mcp

by bigtimer-dev

nk-dho924s-mcp

MCP server that lets an AI assistant (Claude Code, Claude Desktop, any MCP client) drive an oscilloscope running the NK TECHNOLOGIES DHO924S firmware, a modded scope app (0.5.2, reports NK TECHNOLOGIES,DHO924S,…,00.05.02) for Rigol DHO800/900-series scopes, over LAN SCPI (TCP port 5555).

It works around this firmware's SCPI quirks so the scope does not keep dropping the connection.

Tools

Tool

What it does

status

Identity, acquisition, timebase, trigger and per-channel settings

screenshot

Screen capture as a PNG image (1024x600, ~0.3 s)

set_channel

Display, V/div, offset, coupling, probe ratio, invert

set_timebase

s/div and horizontal offset

set_trigger

Edge trigger: source, level, slope, sweep (AUTO/NORM/SING)

acquire

run / stop / single / force / autoscale / clear

measure

Measurements computed from one frozen acquisition of one or more channels: Vpp, robust Vpp, min/max/mean, RMS, FFT frequency, fundamental amplitude and phase, phase between channels, crest factor, THD+N, clipping

get_waveform

Downloads the on-screen record as a time/volts CSV (path returned), optionally inline points

scpi

Raw SCPI command or query (dangerous queries blocked, see below)

Related MCP server: LeCroy Oscilloscope MCP

Firmware quirks (00.05.02)

  • :MEAS:ITEM? … crashes the SCPI server: the connection drops and the port refuses connections for about 10 s. The server blocks those queries; measure computes everything from :WAV:DATA? instead.

  • Many quick connections also upset it: the server keeps one persistent socket and paces commands.

  • A channel's V/div only changes while the channel is displayed (set_channel handles this).

  • Unsupported queries (e.g. :CHAN1:BWL?) never answer. After a timeout the client reconnects so replies stay in sync.

Install

uv tool install git+https://github.com/bigtimer-dev/nk-dho924s-mcp
claude mcp add --scope user nk-dho924s -e DHO_HOST=192.168.1.174 -- nk-dho924s-mcp

Environment: DHO_HOST (default 192.168.1.174), DHO_PORT (default 5555).

Claude Desktop / other clients: run nk-dho924s-mcp as a stdio server with the same environment variables.

Develop

uv venv && uv pip install -e .
.venv/bin/python -m unittest discover -s tests

Safety

Changing scope settings changes the user's bench. The server's instructions ask the assistant to report what it changes and to restore settings it changes temporarily. Nothing in this server writes to the scope's storage or firmware.

License

MIT

Available Tools

9 tools
acquireA

Run/stop/single acquisition, force a trigger, autoscale (changes many settings!) or clear the display.

Inputs: action (required). Returns: result

get_waveformB

Download the displayed record (~1000 points) of a channel. Saves time,volts CSV to a temp file and returns its path plus measurements; optionally include up to max_points_inline decimated points inline.

Inputs: channel (required), save_csv, max_points_inline. Returns: result

measureB

Measure channels from one downloaded acquisition: Vpp, robust Vpp, min/max/mean, RMS, frequency (FFT), fundamental amplitude/phase, crest factor, THD+N, clipping. stop_first freezes one acquisition so channels are comparable (acquisition is resumed afterwards if it was running).

Inputs: channels (required), stop_first, frequency_hint_hz. Returns: result

scpiA

Send a raw SCPI command. Commands ending in '?' return the answer. :MEAS:ITEM? is blocked (crashes the firmware's SCPI server). Unsupported queries time out after ~6 s and the connection is re-opened.

Inputs: command (required). Returns: result

screenshotA

Capture the scope screen as a PNG image (1024x600).

Inputs: no named parameters.

set_channelB

Change channel settings; only the given ones are changed. Returns the new channel state.

Inputs: channel (required), probe, invert, display, +3 more. Returns: result

set_timebaseB

Set horizontal scale (s/div) and/or trigger position offset (s). Returns the new timebase.

Inputs: offset_s, scale_s_div. Returns: result

set_triggerC

Edge trigger settings; only given ones are changed. Returns the trigger state.

Inputs: slope, sweep, source, level_v. Returns: result

statusC

Identity plus acquisition, timebase, trigger and channel settings (default: all 4 channels).

Inputs: channels. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools target clearly distinct operations: set_channel, set_timebase, set_trigger, acquire, status, and screenshot are easy to distinguish. There is some overlap between measure and get_waveform because both can return measurements, and the generic scpi tool can duplicate nearly any operation, but the descriptions give enough guidance to choose correctly.

    Naming Consistency3/5

    The set_* tools follow a clean verb_noun pattern, and get_waveform fits that style, but status, screenshot, and scpi are noun-only names while acquire and measure are bare verbs. The names are readable but use mixed conventions rather than one predictable pattern.

    Tool Count5/5

    Nine tools is well within the ideal 3-15 range for an oscilloscope-control server. Each tool covers a meaningful capability, and there are no redundant or obviously filler tools.

    Completeness4/5

    The surface covers the core oscilloscope workflow: status inspection, channel/timebase/trigger configuration, acquisition control, screenshot capture, measurements, waveform download, and raw SCPI for advanced cases. Minor gaps remain, such as only edge trigger support in set_trigger and no explicit setup save/recall, but the raw SCPI tool provides a workaround.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables control and querying of Rigol DHO824 oscilloscopes, allowing users to capture waveforms, take screenshots, and interact with oscilloscope settings through natural language.
      62 PyPI
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables remote control of LeCroy oscilloscopes via SCPI commands over LAN to perform waveform capture, screenshots, measurements, channel configuration, and triggering through natural language. Supports multiple LeCroy models including WaveSurfer, HDO, WaveRunner, and WavePro series with automatic model detection.
      48
      11
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to control Rigol MSO5000 oscilloscopes through VISA, including acquisition, channels, trigger, timebase, waveform generator, display, and front-panel controls, with risk-based permission gating for direct SCPI operations.
      6
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLMs to control RIGOL oscilloscopes over SCPI via LAN or USB, including configuring channels/timebase/trigger, taking measurements, capturing waveforms and screenshots, decoding serial protocols, running FFT analysis, and controlling the built-in AFG.
      38
      MIT