rigol-oscilloscope-mcp

Ein MCP-Server (Model Context Protocol), der es LLMs (Claude, Codex usw.) ermöglicht, RIGOL-Oszilloskope über SCPI (LAN / USB) zu steuern — Verbinden, Konfigurieren von Kanälen/Zeitbasis/Trigger, Messen, Erfassen von Wellenformen und Screenshots, Dekodieren serieller Protokolle, hostseitige FFT-Analyse und Steuerung des integrierten AFG, alles über semantische Tools mit einer vierstufigen Sicherheitsrichtlinie. Verifiziert an einem echten RIGOL MHO98; andere RIGOL-Modelle funktionieren nach bestem Bemühen über Geräteprofile. Die Dokumentation ist derzeit auf Japanisch.

Ein MCP-Server, der es ermöglicht, RIGOL-Oszilloskope über LLMs zu steuern.

Natürlichsprachliche Anweisungen wie „Zeig mir die 1-kHz-3-V-Wellenform mit einem x10-Tastkopf" oder „Mach einen Screenshot der aktuellen Wellenform und speichere ihn" werden vom LLM (Claude / Codex usw.) in MCP-Tool-Aufrufe umgewandelt, und dieser Server steuert das Gerät über SCPI (LAN / USB). Es wird keine GUI-Automatisierung verwendet.

• Mit echtem RIGOL MHO98 verifiziert (→ docs/verification/mho98-mvp.md)

• Andere RIGOL-Modelle werden nach bestem Bemühen über Geräteprofile unterstützt (unbekannte Modelle funktionieren mit dem generischen Profil, was entsprechend gekennzeichnet wird)

• Andere Hersteller als RIGOL werden nicht unterstützt (bei der Verbindung wird eine Warnung zurückgegeben, aber nicht abgelehnt)

Funktionen

• Gesprächsbasierte Verbindung — Das Verbindungsziel wird grundsätzlich vom Benutzer im Gespräch angegeben (connect(address="...")). Die Standardwerte der Umgebungsvariablen sind ein optionaler Fallback

• 26 MCP-Tools — Verbindung / Identifikation / Statusabfrage / Messung / Wellenform / Analyse (Statistik, FFT) / Screenshot / Kanal-, Zeitbasis- und Trigger-Konfiguration / Run, Stop, Single, Autoset / Serielle Decodierung: Konfiguration und Ergebnisabfrage / Signalgenerator (AFG): Konfiguration, Statusabfrage und Ausgangssteuerung (Ausgang EIN mit Bestätigungsablauf). Der LLM muss keine SCPI-Strings schreiben; es werden nur semantische Tools bereitgestellt

• Sicherheitsrichtlinie mit 4 Klassen + Confirm-Token — Alle Operationen werden in READ_ONLY / SAFE_WRITE / RESTRICTED_WRITE / DANGEROUS_WRITE eingeteilt. 50-Ω-Eingang und Auto Setup erfordern eine host-UI-unabhängige zweistufige Bestätigung (Confirm-Token)

• Screenshot-Speicherung — Speicherung als png / jpg / bmp / webp unter dem angegebenen Pfad; das Bild selbst wird auch an das LLM zurückgegeben (der Schreibort ist auf erlaubte Verzeichnisse beschränkt)

• Geräteprofile — SCPI-Dialekt, Funktionsumfang und Parameterbereiche werden in mitgelieferten YAML-Dateien deklariert und in drei Ebenen aufgelöst: exakte Modellübereinstimmung → Familie → generisches RIGOL

• Rückgabe von requested / applied — Da es modellabhängig ist, ob das Gerät die Sollwerte anpasst (snappt), werden sowohl der angeforderte als auch der ausgelesene Wert zurückgegeben

• Audit-Log — Schreiboperationen werden mit Before / Action / After als JSONL protokolliert

Related MCP server: Rigol DHO824 MCP Server

Installation und Start

Der Start per uvx aus dem GitHub-Repository ist der Standard.

uvx --from git+https://github.com/zinntikumugai/rigol-oscilloscope-mcp@v0.1.0 rigol-oscilloscope-mcp

Standardmäßig ist die Version auf das Tag (@v0.1.0) festgelegt. Wenn Sie die neueste Entwicklungsversion (main) verwenden möchten, entfernen Sie @v0.1.0.

Claude Code — Plugin (empfohlen)

Dieses Repository dient zugleich als Claude-Plugin; neben dem MCP-Server werden auch Mess-Workflow-Skills (empfohlene Einstellungen je Signaltyp, Messverfahren für UART/unbekannte Signale, Sicherheits-Prompts) installiert. Fügen Sie zuerst den Marktplatz hinzu und installieren Sie dann (@ gefolgt vom Marktplatznamen):

/plugin marketplace add zinntikumugai/rigol-oscilloscope-mcp
/plugin install rigol-oscilloscope@rigol-oscilloscope-mcp

Claude Code (.mcp.json oder claude mcp add)

{
  "mcpServers": {
    "rigol-oscilloscope": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/zinntikumugai/rigol-oscilloscope-mcp@v0.1.0", "rigol-oscilloscope-mcp"],
      "env": { "RIGOL_MCP_SCREENSHOT_DIR": "~/scope-captures" }
    }
  }
}

Codex — Plugin

Ein Codex-Plugin (.codex-plugin/ + Marktplatzdefinition) ist ebenfalls enthalten und ermöglicht die gemeinsame Installation von MCP-Server und Mess-Workflow-Skills.

codex plugin marketplace add zinntikumugai/rigol-oscilloscope-mcp
codex plugin install rigol-oscilloscope

(Wenn Sie das Plugin nicht verwenden, werden die Skills auch erkannt, wenn Sie nur skills/measurement-workflows nach ~/.agents/skills/ kopieren. Für nur den MCP-Server reicht die folgende config.toml-Konfiguration)

Codex (~/.codex/config.toml)

[mcp_servers.rigol-oscilloscope]
command = "uvx"
args = ["--from", "git+https://github.com/zinntikumugai/rigol-oscilloscope-mcp@v0.1.0", "rigol-oscilloscope-mcp"]

[mcp_servers.rigol-oscilloscope.env]
RIGOL_MCP_SCREENSHOT_DIR = "~/scope-captures"

Start aus einem lokalen Clone

Wenn Sie das Repository lokal klonen und die Entwicklungsversion verwenden möchten, starten Sie mit uv run --directory.

{
  "mcpServers": {
    "rigol-oscilloscope": {
      "command": "/path/to/uv",
      "args": ["run", "--directory", "/path/to/rigol-oscilloscope-mcp", "rigol-oscilloscope-mcp"],
      "env": { "PYTHONDONTWRITEBYTECODE": "1" }
    }
  }
}

• command wird als absoluter Pfad angegeben, wenn uv nicht im PATH des GUI-Hosts (Desktop-App) vorhanden ist. Den Pfad ermitteln Sie mit which uv (bei mise-Verwaltung mit mise which uv)

• PYTHONDONTWRITEBYTECODE=1 explizit angeben. Da beim Start außerhalb des Projekts das [env] in mise.toml nicht greift, verhindert dies, dass __pycache__ in den Clone geschrieben wird

• Der Standard-Speicherort für Screenshots ist nicht das mit --directory gewechselte Verzeichnis, sondern das Ausführungsverzeichnis, in dem der Server gestartet wurde. Wenn Sie ihn festlegen möchten, geben Sie RIGOL_MCP_SCREENSHOT_DIR an

• Auch bei einem relativen Pfad in path gilt dieser Standard-Speicherort als Basis. Außerhalb des Standard-Speicherorts, von RIGOL_MCP_ALLOWED_DIRS und des temporären Verzeichnisses kann nicht gespeichert werden (wird abgelehnt)

Konfiguration (Umgebungsvariablen)

Alle Einstellungen können über Umgebungsvariablen angegeben werden (eine TOML-Konfigurationsdatei ist optional ebenfalls möglich). Die Prioritätsreihenfolge ist Tool-Argumente (Benutzeranweisungen im Gespräch) > Umgebungsvariablen > Konfigurationsdatei > eingebaute Standardwerte.

Details finden Sie in Kapitel 9 von docs/Requirements.md.

Ausprobieren ohne echtes Gerät

Wenn Sie mit RIGOL_MCP_FAKE=1 starten, wird statt des echten Geräts eine Verbindung zum integrierten FakeScope hergestellt. So können Sie die MCP-Konfiguration des Hosts und den Gesprächsablauf prüfen, ohne ein Oszilloskop bereitzustellen.

RIGOL_MCP_FAKE=1 uvx --from git+https://github.com/zinntikumugai/rigol-oscilloscope-mcp@v0.1.0 rigol-oscilloscope-mcp

Entwicklung

Die Python-Version wird mit mise verwaltet, Abhängigkeiten und virtuelle Umgebung mit uv.

mise install          # Python + uv
uv sync               # 依存の解決
uv run pytest         # ユニットテスト(実機不要)
uv run rigol-oscilloscope-mcp   # stdioで起動

Die Tests mit echtem Gerät werden nur ausgeführt, wenn das Verbindungsziel über eine Umgebungsvariable übergeben wird (ohne Angabe werden sie automatisch übersprungen). Die IP-Adresse des echten Geräts darf niemals ins Repository geschrieben werden (tests/test_ip_guard.py prüft dies maschinell).

# read-only スイート(機器の設定を変更しない)
RIGOL_TEST_ADDRESS=<あなたのオシロのIP> uv run pytest -m device

# write スイート(設定変更 → read-back → 必ず復元)。二重ゲート
RIGOL_TEST_ADDRESS=<あなたのオシロのIP> RIGOL_TEST_ALLOW_WRITE=1 uv run pytest -m device_write

Setzen Sie für <Ihre-Oszilloskop-IP> die Adresse Ihres eigenen Geräts ein (wenn ein Beispiel benötigt wird, verwenden Sie das für die Dokumentation reservierte 192.0.2.x (TEST-NET-1)).

Fehlerbehebung

Sicherheitshinweise

Viele RIGOL-Oszilloskope, einschließlich des MHO98, sind nicht isoliert (das GND jedes Eingangs ist mit dem GND von Gehäuse, USB usw. gemeinsam; Messkategorie Category I). Dieser Server verhindert gefährliche Konfigurationsänderungen, garantiert jedoch nicht die elektrische Sicherheit selbst.

• Der Anschlusspunkt des Tastkopfs, der Anschlusspunkt des Ground Clips, die tatsächliche Spannung des DUT, die Spannungsfestigkeit des Tastkopfs und der Isolationszustand können vom MCP nicht überprüft werden

• **Die Messung von Netzspannung (100 V AC, Steckdose, Primärseite, AC mains) ist ausgeschlossen.** Messverfahren mit normalen passiven Tastköpfen werden nicht automatisch ausgeführt. Voraussetzung ist, dass ein Mensch die Verwendung von Differenz- oder Isolationstastköpfen bestätigt

• Firmware-Update / Kalibrierung / Factory-Service-Operationen / Änderung der Netzwerkeinstellungen sind ausgeschlossen

Details finden Sie in Kapitel 6 (Sicherheitsanforderungen) von docs/Requirements.md.

Vertrauensmodell des Confirm-Ablaufs: Die zweistufige Bestätigung (Confirm-Token) dient dazu, Fehlbedienungen und vorschnelle Schlüsse des LLM zu verhindern; sie ist kein Schutz vor einem böswilligen MCP-Host (da das Token an denselben Aufrufer zurückgegeben wird, kann ein böswilliger Host es einfach durch zwei Aufrufe umgehen). Die physische Sicherheit kann nur durch den Menschen gewährleistet werden, der darüber wacht, was verdrahtet ist. Das Token von enable_afg ist außerdem an die AFG-Konfiguration zum Zeitpunkt der Ausstellung gebunden; wenn die Einstellungen (z. B. Amplitude) nach der Ausstellung geändert werden, wird das Token ungültig.

Haftungsausschluss: Diese Software wird ohne Gewährleistung bereitgestellt (LICENSE). Der Autor übernimmt keine Haftung für Schäden an Messgeräten, Prüflingen (DUT) oder Peripheriegeräten, für fehlerhafte Messergebnisse oder für daraus entstehende Schäden, die durch die Verwendung dieser Software verursacht werden.

Lizenz

MIT License — Copyright (c) 2026 zinntikumugai

Dokumentation

docs/README.md enthält eine Liste der Dokumente und die empfohlene Lesereihenfolge.

• docs/Requirements.md — Anforderungsdefinition (normativ)

• docs/tools.md — MCP-Tool-Katalog

• docs/device-profiles.md — Spezifikation der Geräteprofile

• docs/verification/ — Aufzeichnungen der Verifizierung mit echten Geräten

• docs/roadmap.md — Geplante zukünftige Unterstützung