🎭 DMX to GDTF Matcher

🤖 Fixture Finder pro AI agenty a aplikace: MCP a JSON API

Stejné hledání, skóre i limity jako na této stránce – pro AI asistenty, agenty i vlastní software. Bez přihlášení a bez API klíče.

MCP server (Model Context Protocol)

• Endpoint https://gdtf-lights.com/mcp (Streamable HTTP, JSON-RPC 2.0 přes POST). Přidejte ho do svého AI klienta jako vzdálený MCP server.
• Nástroj match_dmx_channels: zadejte channels (názvy kanálů v pořadí DMX od adresy 1) nebo text (vložený seznam nebo profil svítidla TXT). Volitelně: manufacturer, limit 1–10, include_diff.
• Odpověď obsahuje matches[] se score (0–100 %), shodným DMX módem mode.name a odkazy na soubor GDTF, Můj seznam a export MVR. Uvádí také confidence a same_score_count.
• Další krok: předejte id a mode.name nalezeného svítidla nástroji generate_mvr a dostanete 3D scénu MVR se svítidly zapatchovanými v tomto DMX módu.

Příklad: 13 kanálů otočné hlavy SOH najde právě jedno svítidlo se shodou 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

• Pošlete JSON tělo metodou POST na https://gdtf-lights.com/dmx-to-gdtf. Vstupy i odpověď jsou stejné jako u nástroje MCP, odpověď navíc obsahuje success.
• GET https://gdtf-lights.com/dmx-to-gdtf?format=json popisuje vstup a limity.
• Chyby nesou code a reason. HTTP 429 a 503 navíc uvádějí retry_after a hlavičku 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}'

Limity a tipy

• JSON API a nástroj MCP: na jednu IP 20000 hledání denně a 300 za minutu, pro všechny klienty dohromady 500 za minutu a 10000 za hodinu (429 s reason global). Tato stránka má vlastní limit: 500 denně a 14 za minutu na IP. Na serveru běží najednou nejvýš 3 hledání; když jsou všechna obsazená, odpověď je 503 s reason server_busy (zkuste znovu za 5 s). Den se nuluje v 00:00 UTC.
• Když má nejlepší skóre víc svítidel (same_score_count > 1), nevybírejte naslepo. Doplňte výrobce nebo DMX hodnoty jako řádky v text, např. Strobe;0;Open;10;Slow to fast.

Úplná dokumentace (anglicky): llms.txt (oddíly „MCP server“ a „Machine catalog API“, všechny nástroje MCP a generování MVR), OpenAPI 3.1 (tag dmx) a katalog API.