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 주소를 기록해 두세요. 연결 문자열에 필요합니다.

스코프의 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.와 제휴, 보증 또는 후원 관계가 없습니다. 모든 제품 및 회사 이름은 각 소유자의 상표 또는 등록 상표입니다.