lecroy-mcp

MCP-сервер для управления осциллографами LeCroy через SCPI по локальной сети (VXI-11) или USB.

Требования

• Установленный uv

• Осциллограф LeCroy, подключенный по локальной сети или USB

Конфигурация MCP

Добавьте в конфигурацию вашего MCP-клиента (например, .mcp.json для Claude Code):

{
  "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-адрес — он понадобится для строки подключения

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)

Установите LECROY_HOST в блоке env, и сервер будет автоматически подключаться при запуске:

{
  "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

Затем используйте lecroy-mcp в качестве команды в вашей конфигурации MCP вместо uvx lecroy-mcp.

Обновление

С uvx используйте тег @latest, чтобы принудительно установить последнюю версию:

uvx lecroy-mcp@latest

Или обновите args в вашем .mcp.json, чтобы всегда получать последнюю версию:

"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. Все названия продуктов и компаний являются товарными знаками или зарегистрированными товарными знаками соответствующих владельцев.