bigskymx-mcp

Steuere ein Strymon BigSky MX über USB-MIDI, von der Kommandozeile oder von Claude aus.

Erste Schritte

Du benötigst:

• Nixie 2, Strymons kostenloser Editor

• Python 3.10 oder neuer

• git

Entwickelt und getestet auf macOS. Es sollte überall funktionieren, wo python-rtmidi läuft; unter Linux sind ALSA-Entwicklungsheader erforderlich, falls pip es aus dem Quellcode bauen muss.

1. Schließe das Pedal an deinen Computer an

2. Öffne Nixie 2 und lasse es laufen

Ein frisch verbundenes Pedal sendet keine MIDI-Daten, bis eine Editorsitzung existiert. Nixie beeinträchtigt dieses Tool nicht.

3. Installation

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

Füge [mcp] hinzu, wenn du nur die Kommandozeile benötigst. Dadurch wird bigsky in .venv/bin abgelegt, nicht in deinem PATH; uv tool install . oder pipx install . installiert bigsky systemweit. Beispiele unten verwenden den einfachen Namen.

4. Prüfe die Funktion

.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

Befehle

Tägliche Nutzung

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

Auswahlparameter verwenden Namen, nicht Nummern. --channel ist standardmäßig auto und liest den Kanal vom Pedal.

Offline, ohne Pedal

Arbeit am Protokoll

scripts/full_review.py setzt jeden Parameter jeder Maschine auf beiden Engines und prüft den Bericht des Pedals. Es besteht 299/303; die vier Fehlschläge sind INF MIX, das kein CC hat.

Verwendung mit Claude

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

Claude Desktop, in claude_desktop_config.json:

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

Der Pfad muss absolut sein. Der Client startet den Server und erbt nicht deine Shell.

bigsky_set_params nimmt eine gesamte Änderung auf einmal und wendet sie in der vom Pedal geforderten Reihenfolge an:

1. Gemeinsame globale Parameter, da DUAL und PERSIST das Preset neu laden

2. Der Maschinentyp

3. Die eigenen Parameter dieser Maschine

4. OUTPUT LEVEL, PAN und INF MODE, die einen Typwechsel überleben

5. Die kontinuierlichen Regler

bigsky_save_preset_file verweigert das Überschreiben einer vorhandenen Datei, es sei denn, es wird zweimal gefragt.

Setze BIGSKY_PRESETS in der env-Umgebung des Servers, um Sounds an einem anderen Ort als presets/ zu speichern.

Was es nicht kann

• In einem nummerierten Slot speichern. Ich habe keine MIDI-Nachricht gefunden, die dies tut. Wähle einen Sound ein und speichere ihn manuell auf dem Pedal oder in Nixie.

• INF MIX setzen. Es ist in Strymons Schema, aber in keiner CC-Tabelle.

• PARAM 1 und PARAM 2 zuweisen. CC 19-22 steuern das, was bereits zugewiesen ist; nichts adressiert die Zuweisung. Presets speichern sie als Namen, daher erscheint es einstellbar. load listet diese separat von echten Fehlschlägen auf.

Die CC-Tabelle

Transkribiert in cc.py aus dem Handbuch (Rev B, Seiten 70-76). Skaliert bedeutet, dass CC 0-127 einen größeren internen Bereich abdeckt; direkt bedeutet, dass der CC-Wert der Wert ist und am Maximum begrenzt wird.

Maschinenspezifische Parameter sind in cc.MACHINE_CC.

Falle: Das blinde Durchsuchen von CCs trifft auf 83 und tauscht das Preset stillschweigend aus, während du etwas testest.

Zwei Korrekturen am Handbuch, beide hardware-seitig bestätigt:

• Persist ist invertiert. Das Handbuch sagt 0 = Aus. Das Pedal meldet CC 84 = 0 als EIN.

• Shimmer Shift 2 ist CC 73/74, nicht das gedruckte 72/73, was mit Shift 1 kollidiert.

Das Frame-Format

Presets und Status sind UTF-8-JSON in SysEx.

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

Die Bytereihenfolge ist Produkt, dann Gerät, dann Opcode.

Das JSON beginnt immer bei Byte 14. Suche nicht nach der ersten {: Die Bytes 12-13 enthalten die Länge, und ein niederwertiges Byte von 0x7B ist selbst ein ASCII {, daher beginnt die Suche ein Byte zu früh und die Analyse schlägt fehl. Dies tritt auf, wenn die Gesamtlänge modulo 128 123 beträgt. Verwende sysex.payload_json.

Die beiden Richtungen verwenden unterschiedliche Header-Längen. Pedal-zu-Rechner sind 14 Bytes vor dem JSON. Rechner-zu-Pedal sind 10, ohne Längenbytes: 00 01 55 18 01 39 00 01 01 01 dann das JSON.

Status-Frames können partiell sein, ein Parameter nach dem anderen:

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

Opcodes

Das Pedal antwortet mit 0x46 auf alles, was es nicht implementiert.

Die Gen-1-Befehle sind verschwunden. Diese alle NAK:

Nur 0x21 wurde übernommen. Alle vier sind für TimeLine, Mobius und Gen-1 BigSky in Strymons eigenem Bibliothekar strymon/spl dokumentiert, in spl/DcMidiDevDefs.h.

0x4A wählt einen Slot aus. Es ist kein Speichervorgang, und Nixie sendet die identische Nachricht, wenn du auf ein Preset in seiner Liste klickst.

Fallstricke

• Das Pedal ignoriert jede Nachricht auf einem anderen MIDI-Kanal als dem eigenen, ohne Fehler. Ein falscher Kanal sieht genauso aus wie eine funktionierende Verbindung.

• Schreibvorgänge erfolgen über CC. Das Zurücksenden des eigenen Status-Frames an das Pedal funktioniert ebenfalls und erreicht die volle interne Auflösung, hört aber nach einer Weile auf zu wirken und kehrt stillschweigend zurück. live.set_param setzt dies immer noch aus.

• Ein JSON-Status-Schreibvorgang ignoriert einen Wert von 0 und belässt den alten Wert.

• Der Maschinentyp kann nicht durch einen JSON-Schreibvorgang geändert werden. Dafür wird CC 1/2 benötigt.

• DUAL und PERSIST veranlassen das Pedal, das Preset neu zu laden, wodurch vorherige Änderungen rückgängig gemacht werden. Setze zuerst globale Parameter.

• Das Pedal spiegelt das Gesendete zurück, bevor es seine eigenen Grenzen anwendet. Eine zu schnelle Überprüfung meldet daher Erfolg für einen Wert, der dann begrenzt wird.

• Das Auslesen des Streams ohne Leeren liefert eine veraltete Momentaufnahme.

• Das erneute Senden einer Programmänderung für das aktuelle Preset lädt es nicht neu.

• Decay und Pre-Delay sind Millisekunden auf einer nichtlinearen, maschinenspezifischen Kurve, daher wird der CC-Wert gesucht und nicht berechnet. Mix, Tone und Mod landen innerhalb eines CC-Schritts der Anfrage.

Sicherheit

Firmware-Updates verwenden Opcode 0x43. Alles hier bleibt bei 0x39, daher kann nichts einen Flash auslösen. probe und dump können undokumentierte Opcodes senden und sind hinter --yes geschützt.

Führe bigsky backup out/ vor Experimenten aus.

Eigene Sounds

presets/ wird leer ausgeliefert und ist in .gitignore. Alles, was du dort ablegst, wird von bigsky load und den MCP-Preset-Tools erkannt.

Nicht mit Strymon verbunden

Hierbei handelt es sich um unabhängige Interoperabilitätsarbeit, die weder von Strymon autorisiert noch gebilligt wurde. Strymon, BigSky und Nixie sind Markenzeichen ihrer Eigentümer. Alles hier stammt aus der Beobachtung eines Pedals, das mir gehört, sowie aus dem veröffentlichten Handbuch, mit Ausnahme von bigsky/schema.json, das aus der Nixie 2-Binärdatei abgeleitet wurde.

Geschrieben von Claude Code.

Lizenz

MIT. Siehe LICENSE.