Mettler Toledo Balance

梅特勒-托利多天平 — MCP 服务

让 AI Agent 通过开放的 MT-SICS 接口命令集，操作 梅特勒-托利多天平称量样品、去皮称量容器、记录漂移和蒸发情况、执行内部调整以及控制防风罩。

软件包	labmcp-mettler-toledo
仪器	Excellence XPR/XSR、XP/XS、XA/XE、MS/ML、NewClassic ME/MS，以及其他 MT-SICS 天平和称重终端
接口	RS-232、USB（虚拟 COM 端口）、Ethernet（XPR/XSR，或任何串口转 Ethernet 适配器）
协议	MT-SICS 级别 0–2（参考手册）
状态	🧪 模拟：已通过线路级 MT-SICS 模拟器测试，尚未在硬件上验证。报告硬件测试

无需硬件即可试用

uvx labmcp-mettler-toledo --simulate --check

连接天平

1. **设置天平：**在天平菜单中，将接口（RS232/USB/Ethernet）设为 MT-SICS（有时称为“Host”或“Dialog”）。出厂设置为 9600 波特、8 个数据位、无校验位、1 个停止位、Xon/Xoff。
2. 查找端口：uvx labmcp ports
3. 测试连接：

   uvx labmcp-mettler-toledo --address /dev/ttyUSB0 --check          # Linux
   uvx labmcp-mettler-toledo --address /dev/tty.usbserial-XXXX --check  # macOS
   uvx labmcp-mettler-toledo --address COM4 --check                  # Windows
   uvx labmcp-mettler-toledo --address tcp://192.168.1.60:8001 --check  # Ethernet
   

   非默认设置请在地址中指定：serial://COM4?baudrate=19200&xonxoff=false。

添加到 MCP 客户端

Claude Code

claude mcp add balance -- uvx labmcp-mettler-toledo --address /dev/ttyUSB0

Claude Desktop / Cursor / Windsurf（claude_desktop_config.json、.cursor/mcp.json 等）

{
  "mcpServers": {
    "balance": {
      "command": "uvx",
      "args": ["labmcp-mettler-toledo", "--address", "/dev/ttyUSB0"]
    }
  }
}

添加 --read-only，即可允许称量，但禁止去皮、归零和移动防风罩。对于其他客户端，可使用 uvx labmcp config mettler-toledo --address /dev/ttyUSB0 --client vscode 生成配置片段（也支持 cursor、codex、claude-code）。

工具

工具	类型	描述
clear_tare	🎛 控制	清除去皮存储值（去皮值 = 0）。
get_command_log	👁 读取	返回最近发送给仪器的原始命令及收到的回复（最新记录在最后）。适用于调试和记录操作内容。
get_connection_info	👁 读取	报告当前连接的仪器（身份、地址、模拟或真实）、服务是否为只读，以及当前安全限制。请先调用此工具。
get_draft_shield	👁 读取	报告电动防风罩门的位置（仅适用于 Excellence/XPR 天平）。
get_tare	👁 读取	返回去皮存储值中的当前重量。
log_weight_series	👁 读取	记录一系列即时（未经过滤）读数，用于监测漂移、蒸发、吸湿或稳定情况。返回每条读数及汇总统计数据。
read_temperature	👁 读取	读取天平内部温度探头的温度，单位为 °C（如支持 MT-SICS M28）。
read_weight	👁 读取	读取天平当前的净重。
reconnect	🛑 安全	关闭并重新打开与仪器的连接（例如仪器断电重启或重新插拔电缆后）。
reset_balance	🛑 安全	中止天平正在执行的操作（校准、连续重量数据流或待处理命令），并将其重置为开机状态，但不置零（MT-SICS @）。清除去皮值。电动防风罩门具有独立的障碍物检测功能，遇阻时会反向移动。
run_internal_adjustment	🎛 控制	使用内置参考砝码调整（校准）天平（MT-SICS C3）。秤盘必须为空，且天平不能受到扰动。耗时约 1–3 分钟。
set_draft_shield	⚠️ 危险	打开或关闭电动防风罩门。确保门的移动路径上没有任何物品，也没有人的手指。
set_tare_preset	🎛 控制	预设已知的去皮重量（例如之前称量过的容器）。
show_message	🎛 控制	在天平显示屏上显示一条简短消息（例如“添加样品 3”）。使用 show_weight_display 可返回正常的重量显示。
show_weight_display	🎛 控制	将天平显示屏切换回重量显示。
tare	🎛 控制	对天平去皮：将当前载荷（例如空容器）存储为去皮重量。返回存储的去皮重量。
zero	🎛 控制	根据当前载荷将天平置零。同时清除去皮存储值。

get_connection_info、get_command_log 和 reconnect 内置于每个 LabMCP 服务中。

安全限制

限制	默认值	含义
max_series_duration_s	600 s	Agent 可启动的最长重量记录序列时长

启动时覆盖：--limit max_series_duration_s=3600。无论限制值是多少，单个序列最长为一小时（工具的时间限制）。

示例提示词

• “对天平去皮，然后在我添加样品后，读数稳定时告诉我。”
• “每隔 10 s 记录一次重量，持续 5 分钟，并告诉我蒸发速率是多少 mg/min。”
• “称取约 250 mg：每隔几秒告诉我还需添加多少，直到误差在 ±2 mg 以内。”
• “运行一次内部校准，并在开始校准曲线前确认校准成功。”

注意事项

• read_weight(stable=True) 会发送 S，等待读数稳定。如果天平无法稳定（气流、振动），则会返回 S I。服务端会将其报告为错误，因此请重试或使用 stable=false。
• 重量采用天平的单位 1（通常为克）。显示屏上显示的单位（单位 2）不会影响接口。
• 防风罩（WS）和温度（M28）命令仅适用于配备相应硬件的天平；其他天平会返回 ES/L，服务端会明确报告。
• run_internal_adjustment 会等待最终的 C3 A，且不会阻塞连接：reset_balance 会中止正在运行的调整，并且在调整结束前会拒绝其他命令（否则它们的回复会与调整结果混在一起）。
• 每条命令发送前，服务端都会丢弃天平未经请求发送的任何内容（例如按下打印键后发送的数据），并检查回复是否对应当前命令，避免一条延迟回复导致之后所有回复都错位一条。
• show_message 仅接受可打印的 ASCII 字符，set_tare_preset 仅接受单位符号：否则，换行符可能会作为第二条 MT-SICS 命令发送给天平。

硬件验证

型号	固件	接口	验证者	日期
暂无：抢先验证