io.github.shaag7967Published by GitHub account shaag7967v0.1.1Updated Nov 3, 2026
Measurements with a Siglent SDM3045X bench multimeter via USB or LAN (unofficial)
Unofficial MCP server that lets an assistant take live readings from a Siglent SDM3045X bench multimeter over USB or LAN.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
An MCP server that lets AI assistants take measurements with a Siglent SDM3045X bench multimeter connected via USB or LAN.
Unofficial project, not affiliated with or endorsed by Siglent. Tested with an SDM3045X, firmware 5.02.01.10, over USB (Linux) and LAN.
Every reading comes with its unit, the range used and, where the data sheet gives a single
figure, its accuracy (e.g. ±(0.06 % of reading + 8 counts) as an absolute value). Overloads
are reported as "overload": true instead of the instrument's 9.9E37.
With --allow-scpi one more tool is available:
The raw SCPI tool is off by default because it can change any setting, including the LAN configuration.
Python ≥ 3.10 and uv
The instrument connected to the USB device port on the rear, or to the network.
Linux, USB: the kernel usbtmc driver makes the instrument available as /dev/usbtmc0.
Give logged-in users access with a udev rule:
Windows / macOS, USB: install a VISA (NI-VISA or Keysight IO Libraries) and start the
server with --visa-backend @ivi.
LAN: no extra software. The instrument needs an address in your subnet; then the server
finds it by itself. On the instrument open Utility → I/O Config → LAN Settings and turn on
DHCP, or enter a static IP address, subnet mask and gateway under Modify Settings (User
Manual, section I/O Configuration, available on the
Siglent product page). Check that the
instrument's subnet matches your network: ours came with the static address 10.11.13.220,
which the broadcast search does not reach. While USB is connected,
SYST:COMM:LAN:IPAD? (e.g. with the scpi tool) shows the address in use.
RESOURCE can be a device file (/dev/usbtmc0), an IP address or host name (VXI-11), or any
VISA resource string such as TCPIP::192.168.1.50::5025::SOCKET (raw socket) or
USB0::0xF4EC::0x1203::SDM34XXXXXXXXX::INSTR. Port 5024 is a telnet console and does not work
as a socket resource.
Auto-detection tries /dev/usbtmc* first, then Siglent instruments listed by VISA on USB
(leaving out those already asked through /dev/usbtmc*, since pyvisa-py would take them away
from the kernel driver), then VXI-11 instruments in every network this computer is connected to
(UDP broadcast to the portmapper, about 1 s). It accepts the first one that identifies itself as an SDM3045X. With
several instruments, --serial picks one by its serial number (shown by get_device_info, on
the rear label and under Utility → System Setup → System Info). Set --resource instead if
the instrument is in another subnet, where the broadcast does not reach it; the two options
exclude each other.
To check a real instrument, connect it and run:
The basic checks only use functions that put no current into the inputs. Observed instrument behaviour, including where it differs from the Remote Manual, is described in docs/protocol.md.
MIT
Source: README.md at commit 8358573
Take one reading with the function, range and speed currently set on the instrument. Function, range and speed are kept; the trigger is set to immediate with one reading per trigger, as measure does. Returns value, unit, range, timestamp (UTC) and, where the data sheet allows, the accuracy.
Takes no parameters.
Select a measurement function and take one reading. This switches the instrument (front panel included) to the given function, with autorange unless a range is given. Returns value, unit, range used, timestamp (UTC) and, where the data sheet allows, the accuracy of the reading. Args: function: Measurement function. Leads in HI/LO for voltage, resistance_2w, capacitance, frequency, period, continuity, diode and temperature; in I/LO for currents; resistance_4w also uses HI Sense/LO Sense. range: Fixed range in V, A, Ω or F; omit for autorange. dc_voltage 0.6, 6, 60, 600, 1000; ac_voltage 0.6, 6, 60, 600, 750; dc_current 0.0006, 0.006, 0.06, 0.6, 6, 10; ac_current 0.06, 0.6, 6, 10; resistance_2w/resistance_4w 600, 6000, 60000, 600000, 6e6, 6e7, 1e8; capacitance 2e-9, 2e-8, 2e-7, 2e-6, 2e-5, 0.0002, 0.01. Other functions have no range. speed: Only for dc_voltage, dc_current, resistance_2w, resistance_4w: slow (10 PLC, default, most accurate), medium (1 PLC), fast (0.3 PLC). sensor: Required for temperature: pt100 (RTD) or thermocouple type B, E, J, K, N, R, S or T.
rangespeedsensorfunctionrequiredRecord timestamped readings at a fixed interval and return statistics plus all samples. Readings are paced by this computer. A reading takes about 0.3 s at speed slow and in most other functions, 0.6 s for frequency and period; with a shorter interval readings are taken back to back, and none starts later than one interval after duration_s, so the recording ends on time with fewer samples. Without function the present function and range are kept; otherwise they are set as in measure. Args: duration_s: Recording time in seconds (max 600). interval_s: Time between readings in seconds (min 0.1). function: Measurement function. Leads in HI/LO for voltage, resistance_2w, capacitance, frequency, period, continuity, diode and temperature; in I/LO for currents; resistance_4w also uses HI Sense/LO Sense. range: Fixed range in V, A, Ω or F; omit for autorange. dc_voltage 0.6, 6, 60, 600, 1000; ac_voltage 0.6, 6, 60, 600, 750; dc_current 0.0006, 0.006, 0.06, 0.6, 6, 10; ac_current 0.06, 0.6, 6, 10; resistance_2w/resistance_4w 600, 6000, 60000, 600000, 6e6, 6e7, 1e8; capacitance 2e-9, 2e-8, 2e-7, 2e-6, 2e-5, 0.0002, 0.01. Other functions have no range. speed: Only for dc_voltage, dc_current, resistance_2w, resistance_4w: slow (10 PLC, default, most accurate), medium (1 PLC), fast (0.3 PLC). sensor: Required for temperature: pt100 (RTD) or thermocouple type B, E, J, K, N, R, S or T.
rangespeedsensorfunctionduration_sinterval_sTake a series of readings as fast as the instrument can and return statistics plus all values. Readings are paced by the instrument and have no individual timestamps. Approximate rates (50 Hz mains): dc_voltage, dc_current and resistance 4/s at speed slow, 40/s medium, 175/s fast; ac functions and temperature 4/s; frequency and period 2/s. Bursts estimated to take longer than 600 s are refused. Without function the present function and range are kept; otherwise they are set as in measure. Args: count: Number of readings, 1 to 10000. function: Measurement function. Leads in HI/LO for voltage, resistance_2w, capacitance, frequency, period, continuity, diode and temperature; in I/LO for currents; resistance_4w also uses HI Sense/LO Sense. range: Fixed range in V, A, Ω or F; omit for autorange. dc_voltage 0.6, 6, 60, 600, 1000; ac_voltage 0.6, 6, 60, 600, 750; dc_current 0.0006, 0.006, 0.06, 0.6, 6, 10; ac_current 0.06, 0.6, 6, 10; resistance_2w/resistance_4w 600, 6000, 60000, 600000, 6e6, 6e7, 1e8; capacitance 2e-9, 2e-8, 2e-7, 2e-6, 2e-5, 0.0002, 0.01. Other functions have no range. speed: Only for dc_voltage, dc_current, resistance_2w, resistance_4w: slow (10 PLC, default, most accurate), medium (1 PLC), fast (0.3 PLC). sensor: Required for temperature: pt100 (RTD) or thermocouple type B, E, J, K, N, R, S or T.
countrangespeedsensorfunctionInstrument model, serial number, firmware, VISA resource and the present measurement configuration.
Takes no parameters.
90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
echo 'SUBSYSTEM=="usbmisc", KERNEL=="usbtmc[0-9]*", TAG+="uaccess"' | sudo tee /etc/udev/rules.d/70-usbtmc.rulessudo udevadm control --reload && sudo udevadm triggerclaude mcp add siglent-sdm3045x -- uvx mcp-server-siglent-sdm3045x# fixed address instead of auto-detection:claude mcp add siglent-sdm3045x -- uvx mcp-server-siglent-sdm3045x --resource 192.168.1.50{ "mcpServers": { "siglent-sdm3045x": { "command": "uvx", "args": ["mcp-server-siglent-sdm3045x"] } }}uv syncuv run pytest # tests use a simulated instrumentnpx @modelcontextprotocol/inspector uv run mcp-server-siglent-sdm3045x # try the tools interactivelyuv run python scripts/hardware_test.py # voltage-type functions onlyuv run python scripts/hardware_test.py --with-test-current # also resistance, current, capacitance, …uv run python scripts/hardware_test.py --reconnect # also unplug/replug USB when asked