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)

USB 接続を含む完全な制御には LECROY_RESOURCE を使用します：

{
  "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 設定のコマンドとして uvx lecroy-mcp の代わりに 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 クライアントのログビューアにサーバーのログ出力（自動接続ステータスやエラーなど）が表示されない場合は、env ブロックに PYTHONUNBUFFERED を追加してください：

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

これにより Python の出力バッファリングが無効になり、ログメッセージが即座にフラッシュされます。通常の操作には必須ではありません。

テスト済み環境

このサーバーは、OpenAI Codex や Google Gemini Code Assist などの他の MCP 対応クライアントや、macOS などの他のオペレーティングシステムでも動作するはずです。追加設定に関する報告や貢献を歓迎します。

免責事項

Teledyne LeCroy および LeCroy は、Teledyne LeCroy, Inc. の登録商標です。このプロジェクトは独立したオープンソースツールであり、Teledyne LeCroy, Inc. とは提携、承認、または後援を受けていません。すべての製品名および会社名は、それぞれの所有者の商標または登録商標です。