Bench DC Power Supply

io.github.K-Dense-AI由 GitHub 账号 K-Dense-AI 发布v0.1.3更新于 Oct 24, 2026

MCP server for programmable DC bench power supplies from Rigol, Siglent and Aim-TTi.

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

该 MCP 服务器让助手通过 SCPI 控制 Rigol、Siglent 和 Aim-TTi 可编程直流台式电源,设置电压、电流限制并开关输出。

可以做什么
读取仪器状态:连接信息、各通道设定值、实测电压/电流/功率、CV/CC 模式、保护电平与跳闸状态、错误队列,以及用于调试和记录的原始命令日志。设置通道电压与电流限制设定值,并按安全限值和机型量程校验。单独开启或关闭某个输出,或将全部输出关闭作为紧急停止。配置过压与过流保护,并在排除原因后清除保护跳闸。在断电重启或更换线缆后重新连接仪器。
适用场景
适合让助手操作真实台式电源进行测试测量:设置供电轨、分步升压并回读电流、观察 CV/CC 行为,或快速关闭输出。内置模拟器可在没有硬件时试用。
运行要求
以 Python 包(labmcp-bench-psu,通过 uvx 启动)在本地运行。需要一台受支持的仪器,可通过 USB-TMC、LAN(VXI-11 或原始套接字)、RS-232 或 GPIB 访问,地址由 LABMCP_ADDRESS 或 address 选项提供;已包含 PyVISA,也可改用 NI-VISA 或 Keysight IO Libraries。未声明认证。
安装前请注意
它会为真实负载通电:output_on 会把当前设定值施加到所接负载,输出开启时 set_voltage 会立即改变负载电压。安全限值(max_voltage_v、max_current_a)默认 30 V 和 3 A,应按负载设置;LABMCP_READ_ONLY=1 会隐藏设定值修改和 output_on,但保留 output_off。README 说明仅在模拟器上测试,尚未在硬件上验证,部分机型缺少保护或状态回读。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Bench DC Power Supply,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Bench DC Power Supply — MCP Server

Let an AI agent set voltages and current limits, switch outputs on and off, watch constant-voltage / constant-current behaviour and configure over-voltage / over-current protection on programmable DC bench power supplies from Rigol, Siglent and Aim-TTi, using each vendor's documented remote command set. The dialect is detected from *IDN?.

Packagelabmcp-bench-psu
InstrumentsRigol DP832/DP832A, DP831, DP822, DP821, DP811, DP813, DP711, DP712, DP932A/U/E; Siglent SPD3303X/X-E, SPD1168X, SPD1305X; Aim-TTi CPX400D/DP, MX100T/TP, MX180T/TP, QL355/QL564 (P, T/TP), PL-P (PL068/155/303/601, PL303QMD/QMT)
InterfacesUSB (USB-TMC via VISA, or virtual COM on Aim-TTi), LAN (VISA/VXI-11 or raw socket), RS-232, GPIB via VISA
ProtocolSCPI (Rigol DP800 Programming Guide, DP700, DP900; Siglent SPD3303X Quick Start, SPD1000X User Manual) and Aim-TTi remote commands (CPX400D/DP manual, MX100T/TP manual, manuals index)
Status🧪 simulated: tested against wire-level simulators of each dialect driving a resistive load, not yet verified on hardware. Report a hardware test

Keysight / Agilent and Rohde & Schwarz supplies are intentionally not covered: both vendors publish official MCP servers. Use the Keysight MCP Server for Instrument Control or the MCP server included in Rohde & Schwarz RsInstrument. This server refuses to connect to them.

Try it without hardware

bash
uvx labmcp-bench-psu --simulate --check                                        # Rigol DP832uvx labmcp-bench-psu --simulate --option dialect=siglent --check               # Siglent SPD3303Xuvx labmcp-bench-psu --simulate --option dialect=tti --option sim_model=MX100TP --check

The simulated outputs drive resistive loads (CH1 10 Ω, CH2 100 Ω, CH3 open), so you can watch the CV → CC crossover and trip OVP/OCP.

Connect your instrument

  1. Instrument setup: enable the interface you use (Rigol: Utility → I/O Config; Siglent: System → Interface; Aim-TTi: LAN works out of the box, USB appears as a virtual COM port). Note the IP address or VISA resource string.
  2. Find the address: uvx labmcp ports (serial) or python -m pyvisa info / your VISA vendor's tool (USB/LAN).
  3. Test the connection:
    bash
    uvx labmcp-bench-psu --address "USB0::0x1AB1::0x0E11::DP8C123456789::INSTR" --check   # Rigol over USB-TMCuvx labmcp-bench-psu --address "TCPIP0::192.168.1.50::INSTR" --check                 # any LXI/VXI-11 supplyuvx labmcp-bench-psu --address tcp://192.168.1.51:5025 --check                       # Siglent raw socketuvx labmcp-bench-psu --address tcp://192.168.1.52:9221 --check                       # Aim-TTi raw socketuvx labmcp-bench-psu --address /dev/ttyACM0 --check                                  # Aim-TTi USB virtual COMuvx labmcp-bench-psu --address "serial://COM3?write_termination=CRLF" --check        # Rigol DP800 RS-232
    USB-TMC and VXI-11 addresses use PyVISA (installed with this package; add ?backend=@ivi to use NI-VISA / Keysight IO Libraries instead of pyvisa-py).

Add to your MCP client

Claude Code

bash
claude mcp add psu -- uvx labmcp-bench-psu --address "TCPIP0::192.168.1.50::INSTR" --limit max_voltage_v=12 --limit max_current_a=1

Claude Desktop / Cursor / Windsurf (claude_desktop_config.json, .cursor/mcp.json, …)

json
{  "mcpServers": {    "psu": {      "command": "uvx",      "args": ["labmcp-bench-psu", "--address", "TCPIP0::192.168.1.50::INSTR",               "--limit", "max_voltage_v=12", "--limit", "max_current_a=1"]    }  }}

Add --read-only to allow monitoring only: setpoint changes and output_on are hidden, while output_off and all_outputs_off stay available. For other clients, generate the snippet with uvx labmcp config bench-psu --address TCPIP0::192.168.1.50::INSTR --client vscode.

Tools

ToolKindDescription
all_outputs_off🛑 safetySwitch every output OFF (emergency stop for the whole supply). Each channel is switched individually and read back where the instrument supports it.
clear_protection_trip🎛 controlClear an OVP/OCP trip after fixing its cause. The output stays OFF; use output_on to re-energise. On Aim-TTi supplies this clears trips on all outputs.
get_command_log👁 readReturn the most recent raw commands sent to / replies received from the instrument (newest last). Useful for debugging and for recording what was done.
get_connection_info👁 readReport which instrument is connected (identity, address, simulated or real), whether the server is read-only, and the active safety limits. Call this first.
get_errors👁 readRead (and clear) the instrument's error queue / error registers. Empty list = no errors.
get_outputs👁 readReport each channel: voltage and current-limit setpoints, measured voltage/current/power, output on/off, CV/CC mode, and OVP/OCP levels and trip state where the model supports them.
output_off🛑 safetySwitch a channel's output OFF. Safe to call at any time.
output_on⚠️ hazardSwitch a channel's output ON, energising the connected load at the present setpoints. The setpoints are read back first and the output is refused if they exceed the safety limits (e.g. after someone changed them on the front panel).
reconnect🛑 safetyClose and re-open the connection to the instrument (e.g. after it was power cycled or a cable was re-plugged).
set_current_limit🎛 controlSet a channel's current limit (the constant-current setpoint). Refused above max_current_a (checked even with the output off) or above the channel's range.
set_protection🎛 controlSet over-voltage (OVP) and/or over-current (OCP) protection for a channel. When exceeded, the supply switches the output off. Rigol: levels + on/off; Aim-TTi CPX/QL/PL-P: levels (always armed), MX: levels + on/off; Siglent SPD1000X: levels only; SPD3303X: not available.
set_voltage🎛 controlSet a channel's voltage setpoint. Refused above max_voltage_v (checked even with the output off) or above the channel's range. If the output is on, the load sees the new voltage at once.

get_connection_info, get_command_log and reconnect are built into every LabMCP server.

Safety limits

LimitDefaultMeaning
max_voltage_v30 VLargest voltage setpoint (magnitude) on any channel. Checked when setting the voltage, even with the output off, and again before output_on
max_current_a3 ALargest current-limit setpoint on any channel, checked the same way

Override at launch, e.g. --limit max_voltage_v=12 --limit max_current_a=0.5. Setpoints are also checked against each model's settable range. output_on reads the setpoints back from the instrument first, so a value changed on the front panel cannot slip past the limits.

Example prompts

  • "Show me all channels of the power supply: setpoints, measured current and whether they're in CV or CC."
  • "Set CH1 to 12 V with a 200 mA current limit, set OVP at 13 V, then turn it on and tell me how much current the LED array draws."
  • "Ramp CH2 from 0 to 5 V in 0.5 V steps, reading the current at each step, and plot the I-V curve of the load."
  • "The heater is drawing more than expected: turn every output off now."
  • "Channel 1 tripped. What happened, and is it safe to clear the trip?"

Notes

  • Dialect detection: *IDN? manufacturer "RIGOL" → Rigol, "Siglent" → Siglent, "THURLBY THANDAR"/"TTi"/"Aim" → Aim-TTi. Force one with --option dialect=rigol|siglent|tti for rebadged units. Models not in the built-in table are treated as --option channels=N channels with no model maxima (the safety limits still apply).
  • Rigol: setpoints via :SOUR<n>:VOLT/CURR, readback via :APPL? CHn and :MEAS:ALL? CHn, mode via :OUTP:MODE? CHn (CV/CC/UR), OVP/OCP via :OUTP:OVP|OCP[:STAT|:VAL|:QUES?]. Trips are cleared with :OUTP:OVP|OCP:CLEAR, which only clears the flag. [:SOUR]:VOLT:PROT:CLE is never sent because the programming guide says it also turns the output on. DP831 CH3 is a negative output: give negative voltages (not yet verified on hardware). Over RS-232 the DP800 needs CR LF line endings (?write_termination=CRLF).
  • Siglent: SPD3303X/X-E have no programmable OVP/OCP and report output state and CV/CC only through the SYST:STAT? status word (CH1/CH2). CH3 is fixed (2.5/3.3/5 V by front-panel switch) and can only be switched on/off; its state is not readable. SPD1000X has OVP/OCP levels only (always armed, trip state not readable). The error reply format (0 No Error) is not SCPI-standard, so settings are verified by reading them back. The server pauses 0.1 s after each command to Siglent supplies (--option write_delay_s= to change); Siglent's own examples wait between commands, but the required delay is not documented.
  • Aim-TTi: there is no live CV/CC query, so mode is inferred from readback vs setpoints (mode_source: "inferred"). Trip flags come from the LSR<n>? limit event register, which latches events and is cleared by reading it. CPX/QL/PL-P protection is always armed (levels only); MX models can also switch OVP/OCP on/off. TRIPRST clears trips on all outputs (not documented for MX100T/TP). Original QL P/T models have no output-state query, so their output_on is reported as unknown. OPALL 0 is sent first in all_outputs_off, then every output individually.
  • Tracking / series / parallel modes, timers, sequences, remote sense and saved set-ups are not exposed. Put the supply in independent mode before handing it to an agent.
  • GW Instek GPP and B&K Precision 9130/9140 supplies are not supported yet: too many reply formats are undocumented in their manuals to implement them safely.

Hardware verification

ModelFirmwareInterfaceVerified byDate
none yet: be the first

来源:servers/engineering/bench-power-supply/README.md,提交 46545ea

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

2
  1. v0.1.3最新Sep 27, 2026
  2. v0.1.1Sep 26, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分