bigskymx-mcp

USB MIDI를 통해 Strymon BigSky MX를 제어합니다. 명령줄 또는 Claude에서 사용할 수 있습니다.

시작하기

다음이 필요합니다:

• Nixie 2, Strymon의 무료 에디터

• Python 3.10 이상

• git

macOS에서 개발 및 테스트되었습니다. python-rtmidi가 작동하는 모든 환경에서 동작해야 합니다. Linux의 경우 pip가 소스에서 빌드해야 한다면 ALSA 개발 헤더가 필요합니다.

1. 페달을 컴퓨터에 연결하세요

2. Nixie 2를 열고 실행 상태로 두세요

갓 연결된 페달은 에디터 세션이 존재할 때까지 MIDI를 보내지 않습니다. Nixie는 이 도구와 간섭하지 않습니다.

3. 설치

git clone https://github.com/levinelson/bigskymx-mcp.git
cd bigskymx-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[mcp]"

명령줄만 필요하다면 [mcp]를 생략하세요. 이렇게 하면 bigsky가 .venv/bin에 위치하지만 PATH에는 추가되지 않습니다. uv tool install . 또는 pipx install .을 사용하면 어디에서나 bigsky를 사용할 수 있습니다. 아래 예제에서는 기본 이름을 사용합니다.

4. 작동 확인

.venv/bin/bigsky ports      # BigSkyMX should be listed and auto-detected
.venv/bin/bigsky state      # prints the loaded preset and both engines

Related MCP server: midi-mcp

명령어

일상 사용

bigsky ports                                # list MIDI ports, show auto-detect
bigsky state                                # read the loaded preset
bigsky state --config                       # read global settings
bigsky param TYPE NONLINEAR --engine 1      # switch reverb machine
bigsky param SHAPE BOUNCE --engine 1        # machine-specific, by name
bigsky param Decay 100 --engine 1           # 0-127, scaled to the full range
bigsky param DUAL "SERIES 1 >> 2"           # routing
bigsky param "INF MODE" INFINITE --engine 1
bigsky preset 42                            # recall a slot, 0-299
bigsky load "presets/PAD.json"              # restore a sound to the edit buffer
bigsky backup out/                          # every slot to JSON plus a .syx
bigsky machines                             # every machine and its parameters
bigsky monitor                              # print incoming MIDI

선택 매개변수는 숫자가 아닌 이름을 사용합니다. --channel은 기본값이 auto이며 페달에서 채널을 읽어옵니다.

오프라인, 페달 불필요

프로토콜 작업

scripts/full_review.py는 두 엔진의 모든 머신에 대해 모든 매개변수를 설정하고 페달의 보고를 확인합니다. 299/303 통과; 4개의 실패는 CC가 없는 INF MIX입니다.

Claude와 함께 사용

claude mcp add bigsky -- /full/path/to/.venv/bin/bigsky-mcp

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "bigsky": {
      "command": "/full/path/to/.venv/bin/bigsky-mcp"
    }
  }
}

경로는 절대 경로여야 합니다. 클라이언트가 서버를 실행하며 셸을 상속하지 않습니다.

bigsky_set_params는 전체 변경 사항을 한 번에 가져와 페달이 요구하는 순서대로 적용합니다:

1. 공유 전역, DUAL 및 PERSIST는 프리셋을 다시 로드하기 때문

2. 머신 유형

3. 해당 머신의 자체 매개변수

4. OUTPUT LEVEL, PAN 및 INF MODE (유형 변경 후에도 유지)

5. 연속 노브

bigsky_save_preset_file은 두 번 요청하지 않으면 기존 파일을 덮어쓰지 않습니다.

서버의 env에 BIGSKY_PRESETS를 설정하여 사운드를 presets/ 이외의 다른 위치에 보관할 수 있습니다.

수행할 수 없는 작업

• 번호가 매겨진 슬롯에 저장. 이 작업을 수행하는 MIDI 메시지를 찾지 못했습니다. 사운드를 다이얼로 조정한 후 페달 또는 Nixie에서 수동으로 저장하세요.

• INF MIX 설정. Strymon의 스키마에는 있지만 CC 테이블에는 없습니다.

• PARAM 1 및 PARAM 2 할당. CC 19-22는 이미 할당된 것을 제어합니다. 할당 자체를 다루는 것은 없습니다. 프리셋은 이름으로 저장하므로 설정 가능해 보입니다. load는 실제 실패와 별도로 나열합니다.

CC 맵

cc.py에 매뉴얼(Rev B, 70-76페이지)에서 전사했습니다. Scaled는 CC 0-127이 더 넓은 내부 범위에 걸쳐 있음을 의미합니다. direct는 CC 값이 그 값이며 최대값에서 클램프됨을 의미합니다.

머신별 매개변수는 cc.MACHINE_CC에 있습니다.

주의사항: CC를 무차별 스위핑하면 83을 건드려 테스트 중인 프리셋이 조용히 교체됩니다.

매뉴얼에 대한 두 가지 수정 사항, 하드웨어에서 확인됨:

• Persist가 반전됨. 매뉴얼에는 0 = Off라고 되어 있지만, 페달은 CC 84 = 0을 ON으로 보고합니다.

• Shimmer Shift 2는 CC 73/74이며, 인쇄된 72/73이 아닙니다. 이는 Shift 1과 충돌합니다.

프레임 형식

프리셋과 상태는 SysEx 내부의 UTF-8 JSON입니다.

F0 00 01 55 18 01 39 00 01 01 01 00 00 LL LL {"...json..."} F7
   |________| |  |  |  |  |  |         |___|
   Strymon    |  |  |  |  |  |         total length, 7-bit big endian
   mfr ID     |  |  |  |  |  payload type: 01=state 02=config 06=preset
              |  |  |  |  verb: 01=data 02=request 4A=select a slot
              |  |  |  7F on a preset, 00 on state/config
              |  |  opcode 0x39 = data   (0x43 = firmware update; avoid)
              |  device id 0x01
              product 0x18 = BigSky MX

바이트 순서는 제품, 장치, 그 다음 opcode입니다.

JSON은 항상 14번째 바이트에서 시작합니다. 첫 번째 {를 찾지 마십시오: 바이트 12-13은 길이를 전달하며, 낮은 바이트가 0x7B이면 그 자체가 ASCII {이므로 검색이 한 바이트 일찍 시작되어 구문 분석이 실패합니다. 이는 총 길이 mod 128이 123일 때마다 발생합니다. sysex.payload_json을 사용하세요.

두 방향은 다른 헤더 길이를 사용합니다. 페달->호스트는 JSON 앞에 14바이트입니다. 호스트->페달은 10바이트이며 길이 바이트가 없습니다: 00 01 55 18 01 39 00 01 01 01 다음 JSON.

상태 프레임은 부분적일 수 있으며, 한 번에 하나의 매개변수입니다:

{ "state": { "channel": [{ "TYPE": "CLOUD", "LOW END": 10 }, {}] } }

Opcode

페달은 구현되지 않은 모든 것에 0x46으로 응답합니다.

1세대 명령어 세트는 사라졌습니다. 다음은 모두 NAK입니다:

0x21만 유지되었습니다. 네 가지 모두 Strymon의 자체 라이브러리 strymon/spl의 spl/DcMidiDevDefs.h에 TimeLine, Mobius 및 1세대 BigSky에 대해 문서화되어 있습니다.

0x4A는 슬롯을 선택합니다. 저장이 아니며, Nixie가 목록에서 프리셋을 클릭할 때 동일한 메시지를 보냅니다.

주의사항

• 페달은 자신의 MIDI 채널이 아닌 모든 메시지를 무시하며 오류도 없습니다. 잘못된 채널은 작동하는 연결과 똑같이 보입니다.

• 쓰기는 CC를 통해 이루어집니다. 페달에 자체 상태 프레임을 다시 보내는 것도 작동하며 전체 내부 해상도에 도달하지만, 잠시 후 적용이 중단되고 조용히 되돌아갑니다. live.set_param은 여전히 이를 노출합니다.

• JSON 상태 쓰기는 값이 0이면 무시하고 이전 값을 유지합니다.

• 머신 유형은 JSON 쓰기로 변경할 수 없습니다. CC 1/2가 필요합니다.

• DUAL 및 PERSIST는 페달이 프리셋을 다시 로드하게 하여 이전에 수행한 편집 내용을 되돌립니다. 먼저 전역을 설정하세요.

• 페달은 자체 제한을 적용하기 전에 보낸 내용을 에코하므로, 너무 빨리 확인하면 나중에 클램프되는 값이 성공한 것으로 보고됩니다.

• 스트림을 비우지 않고 읽으면 오래된 스냅샷이 반환됩니다.

• 현재 프리셋에 대한 프로그램 변경을 다시 보내도 다시 로드되지 않습니다.

• Decay 및 Pre-Delay는 비선형 머신별 곡선의 밀리초이므로 CC 값은 계산되지 않고 검색됩니다. Mix, Tone 및 Mod는 요청의 CC 한 단계 이내에 위치합니다.

안전

펌웨어 업데이트는 opcode 0x43을 사용합니다. 여기서는 모든 것이 0x39에 머물므로 플래시를 트리거할 수 없습니다. probe 및 dump는 문서화되지 않은 opcode를 보낼 수 있으며 --yes 뒤에 게이트됩니다.

실험하기 전에 bigsky backup out/을 실행하세요.

나만의 사운드

presets/는 비어서 제공되며 gitignore 처리됩니다. 거기에 넣은 모든 것은 bigsky load 및 MCP 프리셋 도구에 의해 선택됩니다.

Strymon과 관련 없음

이것은 독립적인 상호운용성 작업이며, Strymon의 승인이나 보증을 받지 않았습니다. Strymon, BigSky 및 Nixie는 해당 소유주의 상표입니다. 여기 있는 모든 내용은 제가 소유한 페달 관찰과 공개 매뉴얼에서 얻은 것이며, bigsky/schema.json은 Nixie 2 바이너리에서 파생되었습니다.

Claude Code 작성.

라이선스

MIT. LICENSE 참조.