lecroy-mcp

用于通过 LAN (VXI-11) 或 USB 使用 SCPI 控制 LeCroy 示波器的 MCP 服务器。

要求

• 已安装 uv

• 一台通过 LAN 或 USB 连接的 LeCroy 示波器

MCP 配置

添加到您的 MCP 客户端配置中（例如 Claude Code 的 .mcp.json）：

{
  "mcpServers": {
    "lecroy-scope": {
      "type": "stdio",
      "command": "uvx",
      "args": ["lecroy-mcp"]
    }
  }
}

uvx 将自动下载并运行服务器 — 无需手动安装。

示波器设置 (LAN / VXI-11)

此服务器通过标准的 VXI-11 协议进行通信。在连接之前，请在示波器上启用它：

1. 在示波器上，进入 Utilities → Utilities Setup ... → Remote

2. 在 Control from 部分，启用 LXI (VXI11)

3. 记下显示的 IP Address — 连接字符串中需要用到它

示波器的 IP 可以通过 DHCP 分配，也可以在 Utilities → Utility → Remote → Net Connections 下进行静态配置。

注意： 同一面板中显示的 TCPIP (VICP) 选项使用的是 LeCroy 的专有协议，目前此服务器不支持。仅需要 LXI (VXI11)。

连接选项

选项 1 — 手动连接

按原样复制上面的 MCP 客户端配置，并在 Claude 会话中进行连接：

1. scope_scan — 自动检测本地网络上的 LeCroy 示波器

2. scope_list_resources — 列出所有 VISA 资源 (LAN + USB)

3. scope_connect("TCPIP0::192.168.1.111::inst0::INSTR") — 直接连接

可以选择设置 LECROY_SUBNET 来提示扫描范围：

{
  "mcpServers": {
    "lecroy-scope": {
      "type": "stdio",
      "command": "uvx",
      "args": ["lecroy-mcp"],
      "env": {
        "LECROY_SUBNET": "192.168.1.0/24"
      }
    }
  }
}

选项 2 — 预配置 IP 地址（推荐用于 LAN）

在 env 块中设置 LECROY_HOST，服务器将在启动时自动连接：

{
  "mcpServers": {
    "lecroy-scope": {
      ...
      "env": {
        "LECROY_HOST": "192.168.1.111"
      }
    }
  }
}

选项 3 — 预配置完整的资源字符串（LAN 或 USB）

使用 LECROY_RESOURCE 进行完全控制，包括 USB 连接：

{
  "mcpServers": {
    "lecroy-scope": {
      ...
      "env": {
        "LECROY_RESOURCE": "USB0::0x05FF::0x1023::12345::INSTR"
      }
    }
  }
}

使用方法

连接后，您可以使用以下工具：

• 通道设置（比例、偏移、耦合、带宽限制）

• 触发配置（模式、源、电平、边沿）

• 时基和存储深度

• 自动测量（PKPK、FREQ、RMS、RISE、DUTY 等）

• 波形捕获（JSON 或 CSV）

• 截图

• 数学函数（FFT、INTG、DIFF 等）

• WaveSource 内置发生器（WaveSurfer 3000Z 及类似型号）

支持的型号

服务器会检测连接的型号并相应地调整命令。 包含以下型号的配置文件：

• WaveSurfer 3000Z / 4000HD

• HDO4000A / HDO6000B / HDO8000A

• WaveRunner 6000 / 8000

• WavePro HD

• MDA800A, SDA

未知型号将回退到保守的默认设置。

手动安装

如果您不想使用 uvx：

pip install lecroy-mcp

然后在您的 MCP 配置中使用 lecroy-mcp 作为命令，而不是 uvx lecroy-mcp。

更新

使用 uvx 时，使用 @latest 标签强制更新到最新版本：

uvx lecroy-mcp@latest

或者更新 .mcp.json 中的 args 以始终拉取最新版本：

"args": ["lecroy-mcp@latest"]

使用 pip：

pip install --upgrade lecroy-mcp

注意事项

• 需要 pyvisa-py 后端 — 目前不支持 NI-VISA（会导致截图捕获失败）

• 所有 VISA 访问都通过线程锁进行序列化；并行 MCP 工具调用是安全的

故障排除

诊断消息未出现在 MCP 日志中

如果您在 MCP 客户端的日志查看器中没有看到服务器日志输出（例如自动连接状态或错误），请将 PYTHONUNBUFFERED 添加到 env 块中：

"env": {
  "PYTHONUNBUFFERED": "1"
}

这将禁用 Python 的输出缓冲，以便立即刷新日志消息。正常操作不需要此项。

测试环境

此服务器也应适用于其他兼容 MCP 的客户端，如 OpenAI Codex 和 Google Gemini Code Assist，以及 macOS 等其他操作系统。欢迎报告和贡献其他配置。

免责声明

Teledyne LeCroy 和 LeCroy 是 Teledyne LeCroy, Inc. 的注册商标。本项目是一个独立的开源工具，不隶属于 Teledyne LeCroy, Inc.，也不受其认可或赞助。所有产品和公司名称均为其各自持有者的商标或注册商标。