🎭 DMX to GDTF Matcher

🤖 Fixture Finder für KI-Agenten und Apps: MCP und JSON-API

Dieselbe Suche, dieselben Werte und Limits wie auf dieser Seite – für KI-Assistenten, Agenten und Ihre eigene Software. Ohne Anmeldung und ohne API-Schlüssel.

MCP-Server (Model Context Protocol)

• Endpoint https://gdtf-lights.com/mcp (Streamable HTTP, JSON-RPC 2.0 per POST). Fügen Sie ihn Ihrem KI-Client als Remote-MCP-Server hinzu.
• Tool match_dmx_channels: Übergeben Sie channels (Kanalnamen in DMX-Reihenfolge ab Adresse 1) oder text (eingefügte Liste oder TXT-Geräteprofil). Optional: manufacturer, limit 1–10, include_diff.
• Die Antwort enthält matches[] mit score (0–100 %), dem zugeordneten DMX-Modus mode.name und Links zur GDTF-Datei, zu Meine Liste und zum MVR-Export. Dazu kommen confidence und same_score_count.
• Nächster Schritt: Übergeben Sie id und mode.name eines Treffers an das Tool generate_mvr und erhalten Sie eine 3D-MVR-Szene mit den Scheinwerfern, gepatcht in diesem DMX-Modus.

Beispiel: Die 13 Kanäle eines SOH Moving Heads finden genau einen Scheinwerfer mit 100 % (confidence: high).

curl -s https://gdtf-lights.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "match_dmx_channels",
                  "arguments": {"channels": ["Pan", "Tilt", "Speed Pan/Tilt", "Master Dimmer", "Pattern Dimmer",
                                             "Colors", "Gobo", "Red", "Green", "Blue", "White",
                                             "Master Shutter", "Reset"],
                                "limit": 3}}}'

JSON-API

• Senden Sie einen JSON-Body per POST an https://gdtf-lights.com/dmx-to-gdtf. Eingaben und Antwort sind dieselben wie beim MCP-Tool, die Antwort enthält zusätzlich success.
• GET https://gdtf-lights.com/dmx-to-gdtf?format=json beschreibt Eingabe und Limits.
• Fehler enthalten code und reason. HTTP 429 und 503 liefern zusätzlich retry_after und den Header Retry-After.

curl -s https://gdtf-lights.com/dmx-to-gdtf \
  -H "Content-Type: application/json" \
  -d '{"channels": ["Dimmer", "Red", "Green", "Blue", "White", "Strobe"], "manufacturer": "Chauvet", "limit": 3}'

Limits und Tipps

• JSON-API und MCP-Tool: pro IP 20000 Suchen am Tag und 300 pro Minute, für alle Clients zusammen 500 pro Minute und 10000 pro Stunde (429 mit reason global). Diese Seite hat ein eigenes Limit: 500 am Tag und 14 pro Minute pro IP. Auf dem Server laufen höchstens 3 Suchen gleichzeitig; sind alle belegt, lautet die Antwort 503 mit reason server_busy (in 5 s erneut versuchen). Der Tag beginnt um 00:00 UTC neu.
• Wenn mehrere Scheinwerfer den besten Wert teilen (same_score_count > 1), wählen Sie nicht blind aus. Ergänzen Sie den Hersteller oder DMX-Werte als Zeilen in text, z. B. Strobe;0;Open;10;Slow to fast.

Vollständige Dokumentation (englisch): llms.txt (Abschnitte „MCP server“ und „Machine catalog API“, alle MCP-Tools und die MVR-Erzeugung), OpenAPI 3.1 (Tag dmx) und der API-Katalog.