lecroy-mcp

MCP-Server zur Steuerung von LeCroy-Oszilloskopen via SCPI über LAN (VXI-11) oder USB.

Anforderungen

• uv installiert

• Ein LeCroy-Oszilloskop, das über LAN oder USB angeschlossen ist

MCP-Konfiguration

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. Claudes .mcp.json):

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

uvx lädt den Server automatisch herunter und führt ihn aus — eine manuelle Installation ist nicht erforderlich.

Oszilloskop-Einrichtung (LAN / VXI-11)

Dieser Server kommuniziert über das Standard-VXI-11-Protokoll. Aktivieren Sie es vor dem Verbinden am Oszilloskop:

1. Gehen Sie am Oszilloskop auf Utilities → Utilities Setup ... → Remote

2. Aktivieren Sie im Abschnitt Control from die Option LXI (VXI11)

3. Notieren Sie sich die angezeigte IP-Adresse — Sie benötigen diese für die Verbindungszeichenfolge

Die IP des Oszilloskops kann per DHCP zugewiesen oder statisch unter Utilities → Utility → Remote → Net Connections konfiguriert werden.

Hinweis: Die Option TCPIP (VICP), die im selben Bereich angezeigt wird, verwendet das proprietäre Protokoll von LeCroy und wird derzeit von diesem Server nicht unterstützt. Es ist nur LXI (VXI11) erforderlich.

Verbindungsoptionen

Option 1 — Manuelle Verbindung

Kopieren Sie die MCP-Client-Konfiguration von oben wie sie ist und verbinden Sie sich innerhalb der Claude-Sitzung:

1. scope_scan — LeCroy-Oszilloskope im lokalen Netzwerk automatisch erkennen

2. scope_list_resources — alle VISA-Ressourcen auflisten (LAN + USB)

3. scope_connect("TCPIP0::192.168.1.111::inst0::INSTR") — direkt verbinden

Optional können Sie LECROY_SUBNET setzen, um den Scan-Bereich einzugrenzen:

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

Option 2 — IP-Adresse vorkonfigurieren (empfohlen für LAN)

Setzen Sie LECROY_HOST im env-Block und der Server verbindet sich beim Start automatisch:

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

Option 3 — Vollständige Ressourcen-Zeichenfolge vorkonfigurieren (LAN oder USB)

Verwenden Sie LECROY_RESOURCE für die volle Kontrolle, einschließlich USB-Verbindungen:

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

Verwendung

Sobald die Verbindung hergestellt ist, stehen Ihnen Werkzeuge für Folgendes zur Verfügung:

• Kanaleinrichtung (Skalierung, Offset, Kopplung, Bandbreitenbegrenzung)

• Trigger-Konfiguration (Modus, Quelle, Pegel, Flanke)

• Zeitbasis und Speichertiefe

• Automatisierte Messungen (PKPK, FREQ, RMS, RISE, DUTY, etc.)

• Wellenform-Erfassung (JSON oder CSV)

• Screenshots

• Mathematische Funktionen (FFT, INTG, DIFF, etc.)

• Integrierter WaveSource-Generator (WaveSurfer 3000Z und ähnliche)

Unterstützte Modelle

Der Server erkennt das angeschlossene Modell und passt die Befehle entsprechend an. Profile sind enthalten für:

• WaveSurfer 3000Z / 4000HD

• HDO4000A / HDO6000B / HDO8000A

• WaveRunner 6000 / 8000

• WavePro HD

• MDA800A, SDA

Unbekannte Modelle greifen auf konservative Standardeinstellungen zurück.

Manuelle Installation

Wenn Sie uvx nicht verwenden möchten:

pip install lecroy-mcp

Verwenden Sie dann lecroy-mcp als Befehl in Ihrer MCP-Konfiguration anstelle von uvx lecroy-mcp.

Aktualisierung

Verwenden Sie bei uvx das @latest-Tag, um die neueste Version zu erzwingen:

uvx lecroy-mcp@latest

Oder aktualisieren Sie die args in Ihrer .mcp.json, um immer die neueste Version zu beziehen:

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

Mit pip:

pip install --upgrade lecroy-mcp

Hinweise

• Erfordert das pyvisa-py-Backend — NI-VISA wird derzeit nicht unterstützt (unterbricht die Screenshot-Erfassung)

• Alle VISA-Zugriffe werden über einen Threading-Lock serialisiert; parallele MCP-Tool-Aufrufe sind sicher

Fehlerbehebung

Diagnosemeldungen erscheinen nicht in den MCP-Protokollen

Wenn Sie keine Server-Protokollausgaben (z. B. Auto-Connect-Status oder Fehler) im Protokoll-Viewer Ihres MCP-Clients sehen, fügen Sie PYTHONUNBUFFERED zum env-Block hinzu:

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

Dies deaktiviert die Pufferung der Python-Ausgabe, sodass Protokollmeldungen sofort ausgegeben werden. Dies ist für den normalen Betrieb nicht erforderlich.

Getestet mit

Dieser Server sollte auch mit anderen MCP-kompatiblen Clients wie OpenAI Codex und Google Gemini Code Assist sowie auf anderen Betriebssystemen wie macOS funktionieren. Berichte und Beiträge für zusätzliche Konfigurationen sind willkommen.

Haftungsausschluss

Teledyne LeCroy und LeCroy sind eingetragene Marken von Teledyne LeCroy, Inc. Dieses Projekt ist ein unabhängiges Open-Source-Tool und ist nicht mit Teledyne LeCroy, Inc. verbunden, wird von dieser nicht unterstützt oder gesponsert. Alle Produkt- und Firmennamen sind Marken oder eingetragene Marken ihrer jeweiligen Inhaber.