nk-dho924s-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nk-dho924s-mcp take a screenshot of the scope and check channel 1 settings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Identity, acquisition, timebase, trigger and per-channel settings |
| Screen capture as a PNG image (1024x600, ~0.3 s) |
| Display, V/div, offset, coupling, probe ratio, invert |
| s/div and horizontal offset |
| Edge trigger: source, level, slope, sweep (AUTO/NORM/SING) |
| run / stop / single / force / autoscale / clear |
| 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 |
| Downloads the on-screen record as a time/volts CSV (path returned), optionally inline points |
| 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;measurecomputes 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_channelhandles 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-mcpEnvironment: 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 testsSafety
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 toolsacquireA
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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
IP intelligence, network diagnostics, and AI service availability tools for AI agents.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables control and querying of Rigol DHO824 oscilloscopes, allowing users to capture waveforms, take screenshots, and interact with oscilloscope settings through natural language.62 PyPI7MIT
- AlicenseAqualityDmaintenanceEnables 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.4811AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables 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.6MIT
- AlicenseAqualityCmaintenanceEnables 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.38MIT