Rigol Dho824 MCP

🚀 Rigol DHO824 MCP サーバー

このサーバーは、Rigol DHO824オシロスコープの制御とクエリを行うためのMCP（Model Context Protocol）サーバーです。

ai.modaによって構築されました。

🚀 クイックスタート

このMCPサーバーを使用することで、Rigol DHO824オシロスコープを制御し、波形データを取得することができます。以下の手順に沿ってセットアップを行ってください。

✨ 主な機能

• Rigol DHO824オシロスコープの制御とクエリを行うことができます。
• Dockerを利用した簡単なセットアップが可能です。
• MCPクライアントとの連携が可能です。

📦 インストール

このMCPサーバーを使用する推奨方法は、Dockerを介することです。これにより、依存関係の管理が不要になり、環境を分離することができます。

クイックスタート

GitHub Container Registryから事前にビルドされたイメージを取得します。

docker pull ghcr.io/aimoda/rigol-dho824-mcp:latest

Dockerでの環境変数の使用

重要: RIGOL_RESOURCE環境変数にオシロスコープのIPアドレスを指定する必要があります（例: TCPIP0::192.168.1.100::inst0::INSTR）。

Dockerコンテナを環境変数で構成する方法は2つあります。

1. ハードコードされた値（以下の例で示す）: -e RIGOL_RESOURCE="TCPIP0::192.168.1.100::inst0::INSTR"
2. ホストからのパススルー（推奨）: -e RIGOL_RESOURCE（=valueなし）

-e VARIABLE_NAMEを値なしで使用すると、Dockerは自動的にホスト環境から変数をパススルーします。これは、シェル（例: ~/.bashrcまたは~/.zshrc）にすでに環境変数が設定されている場合に便利です。

環境変数

• RIGOL_RESOURCE: 必須 - オシロスコープに接続するためのVISAリソース文字列（例: TCPIP0::192.168.1.100::inst0::INSTR）
• RIGOL_TEMP_DIR: Dockerで必須 - 返されるファイルパスのホスト側のパス。コンテナは内部的に常に/tmp/rigolに書き込み、応答でこの値にパスを変換します。-vマウントのホストパスと一致する必要があります。Dockerの外では、一時ファイル（波形、スクリーンショット）のディレクトリを設定します。設定されていない場合は、システムのデフォルトの一時ディレクトリを使用します。
• VISA_TIMEOUT: 通信タイムアウト（ミリ秒）（デフォルト: 30000）
• RIGOL_BEEPER_ENABLED: オシロスコープのブザー音を有効/無効にする（デフォルト: false）
• RIGOL_AUTO_SCREENSHOT: 各MCPツール実行後に自動的にスクリーンショットをキャプチャして、視覚化/デバッグを行う（デフォルト: false）。スクリーンショットは人間が読みやすいタイムスタンプ形式（例: auto_screenshot_20251030_143045_123.png）で保存され、時系列でソートできます。

📚 ドキュメント

MCPクライアントの設定

{
  "mcpServers": {
    "rigol-dho824": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/tmp/rigol-data:/tmp/rigol",
        "-e",
        "RIGOL_RESOURCE",
        "-e",
        "VISA_TIMEOUT",
        "-e",
        "RIGOL_BEEPER_ENABLED",
        "-e",
        "RIGOL_AUTO_SCREENSHOT",
        "-e",
        "RIGOL_TEMP_DIR",
        "ghcr.io/aimoda/rigol-dho824-mcp:latest"
      ],
      "env": {
        "RIGOL_RESOURCE": "TCPIP0::192.168.1.100::inst0::INSTR",
        "VISA_TIMEOUT": "30000",
        "RIGOL_BEEPER_ENABLED": "false",
        "RIGOL_AUTO_SCREENSHOT": "false",
        "RIGOL_TEMP_DIR": "/tmp/rigol-data"
      }
    }
  }
}

claude mcp add --scope local rigol-dho824 -- \
  docker run -i --rm \
  -v /tmp/rigol-data:/tmp/rigol \
  -e RIGOL_RESOURCE="TCPIP0::192.168.1.100::inst0::INSTR" \
  -e VISA_TIMEOUT=30000 \
  -e RIGOL_BEEPER_ENABLED=false \
  -e RIGOL_AUTO_SCREENSHOT=false \
  -e RIGOL_TEMP_DIR=/tmp/rigol-data \
  ghcr.io/aimoda/rigol-dho824-mcp:latest

codex mcp add rigol-dho824 -- \
  docker run -i --rm \
  -v /tmp/rigol-data:/tmp/rigol \
  -e RIGOL_RESOURCE="TCPIP0::192.168.1.100::inst0::INSTR" \
  -e VISA_TIMEOUT=30000 \
  -e RIGOL_BEEPER_ENABLED=false \
  -e RIGOL_AUTO_SCREENSHOT=false \
  -e RIGOL_TEMP_DIR=/tmp/rigol-data \
  ghcr.io/aimoda/rigol-dho824-mcp:latest

注意: MCPクライアントにサーバーを追加した後、クライアントを再起動してMCPサーバーを読み込んでください。サーバーは、返されるすべてのファイルパスでコンテナパス（/tmp/rigol/*）をホストパス（/tmp/rigol-data/*）に変換します。

最初のプロンプト

MCPクライアントに以下のプロンプトを入力して、セットアップを確認してください。

Capture a waveform from channel 1 of my oscilloscope

MCPクライアントはオシロスコープに接続し、波形データをキャプチャするはずです。

Dockerでの一時ファイルのアクセス

コンテナは内部的に一時ファイル（波形キャプチャ、スクリーンショット）を/tmp/rigolに書き込みます。ホストマシンからこれらのファイルにアクセスするには、以下の手順を実行します。

1. ホストに一時ファイルを保存するディレクトリを作成します。

   mkdir -p /tmp/rigol-data
   

2. このディレクトリをボリュームとしてマウントし、RIGOL_TEMP_DIRを設定します。

   docker run -i --rm \
     -v /tmp/rigol-data:/tmp/rigol \
     -e RIGOL_TEMP_DIR=/tmp/rigol-data \
     ...
   

サーバーは、返されるすべてのファイルパスをコンテナパス（/tmp/rigol/*）からホストパス（/tmp/rigol-data/*）に自動的に変換するため、ツールの応答に示されるパスで直接ファイルにアクセスできます。

重要な注意事項:

• ホストディレクトリ（例では/tmp/rigol-data）はサーバーを起動する前に存在している必要があります。
• RIGOL_TEMP_DIRは-vマウントのホスト側のパスと一致する必要があります。
• 一時ファイルは自動的に削除されません。
• 古い波形とスクリーンショットファイルの手動削除はユーザーの責任です。
• ファイルは、波形の場合はwaveform_capture_<timestamp>/、スクリーンショットの場合はscreenshot_<timestamp>.pngのようなサブディレクトリに整理されます。

例: 手動削除

# 7日以上古い波形キャプチャを削除する
find /tmp/rigol-data -type d -name "waveform_capture_*" -mtime +7 -exec rm -rf {} \;

# 7日以上古いスクリーンショットを削除する
find /tmp/rigol-data -type f -name "screenshot_*.png" -mtime +7 -delete

トラブルシューティング

コンテナがすぐに終了する

• -iフラグ（インタラクティブモード）を使用していることを確認してください。
• RIGOL_RESOURCEが正しく設定されていることを確認してください。

オシロスコープに接続できない

• オシロスコープのIPアドレスとネットワーク接続性を確認してください（ping <ip-address>）。
• オシロスコープのリモート制御設定が有効になっていることを確認してください。

環境変数が機能しない

• Dockerの引数配列で-e VARIABLE_NAMEを使用していることを確認してください。
• .mcp.jsonのenvフィールドに実際の値を設定してください。

ローカルでのビルド

Dockerイメージを自分でビルドするには、以下のコマンドを実行します。

docker build -t rigol-dho824-mcp:local .

その後、設定でrigol-dho824-mcp:localをイメージ名として使用してください。

開発環境のセットアップ

ローカル開発とコントリビューションのために、Python仮想環境にMCPサーバーをインストールすることができます。

仮想環境の作成とアクティブ化

python3 -m venv venv
source venv/bin/activate  # Windowsの場合は: venv\Scripts\activate

パッケージのインストール

# 開発用に編集可能モードでインストールする
pip install -e .

# または依存関係のみをインストールする
pip install -r requirements.txt

MCPクライアントに追加

上記のセットアップ手順を完了した後、ローカル開発用のMCPサーバーをMCPクライアントに追加します。

Claude Code:

claude mcp add --scope local rigol-dho824 -- <path-to-this-repo>/venv/bin/rigol-dho824-mcp

Codex CLI:

codex mcp add \
  --env RIGOL_RESOURCE="TCPIP0::192.168.1.100::inst0::INSTR" \
  --env VISA_TIMEOUT="30000" \
  --env RIGOL_BEEPER_ENABLED="false" \
  --env RIGOL_AUTO_SCREENSHOT="false" \
  rigol-dho824 -- <path-to-this-repo>/venv/bin/rigol-dho824-mcp

置き換える項目:

• <path-to-this-repo>をこのリポジトリの実際のパスに置き換えます。
• 192.168.1.100をオシロスコープのIPアドレスに置き換えます。

注意: Claude Codeとは異なり、CodexはMCPサーバーをクリーンな環境で実行するため、--envフラグ（サーバー名の前）を介して明示的な環境変数が必要です。

開発用スクリプト

scripts/ディレクトリには、開発用のユーティリティが含まれています。

• convert_png_to_webp.sh - PNGフレームシーケンスをアニメーションWebPに変換する（例: ./scripts/convert_png_to_webp.sh "~/screenshots/*.png" output.webp）

開発用の設定

サーバーは環境変数を使用して構成することができます。サンプルから.envファイルを作成します。

cp .env.example .env

次に、.envを編集して設定を行います。

• RIGOL_RESOURCE: オシロスコープのVISAリソース文字列（必須）
  • 例: TCPIP0::192.168.1.100::inst0::INSTR
• VISA_TIMEOUT: 通信タイムアウト（ミリ秒）（デフォルト: 5000）

サーバーの実行（開発用）

ローカル開発とテストのために、Pythonで直接サーバーを実行することができます。

STDIOトランスポート

# 環境変数を介してリソース文字列を設定する
export RIGOL_RESOURCE="TCPIP0::192.168.1.100::inst0::INSTR"
python -m rigol_dho824_mcp.server

HTTPトランスポート

# デフォルトのHTTPサーバー (http://127.0.0.1:8000/mcp)
python -m rigol_dho824_mcp.server --http

# カスタムホストとポート
python -m rigol_dho824_mcp.server --http --host 0.0.0.0 --port 3000

# カスタムパス
python -m rigol_dho824_mcp.server --http --path /api/mcp

🔧 技術詳細

ハードウェア要件

サポートされるモデル

このプロジェクトはDHO804/DHO824オシロスコープのみをサポートしています（ハードウェアは同一）。DHO804の購入をお勧めします。

ファームウェア要件

重要: このMCPサーバーを使用する前に、DHO804をDHO824のファームウェアにフラッシュする必要があります。rigol_vendor_binプロジェクトを使用してオシロスコープをフラッシュしてください。

サポートされるファームウェアバージョン: 00.01.04

これは、私たちがテストしてサポートする唯一のファームウェアバージョンです。他のファームウェアバージョンも動作する場合がありますが、保証はされません。

互換性に関する注意

他のRigolオシロスコープモデルもこのMCPサーバーで動作する可能性がありますが、テストする方法がなく、機能を保証することはできません。他のモデルでの使用は自己責任で行ってください。