MCP server for SuperCollider audio programming language with tools for process management, documentation search, code execution, and audio diagnostics
Server has 16 tools with consistent naming (verb_noun pattern) and descriptions present for all. However, output schemas are entirely undocumented, no tool declares what fields it returns, forcing LLMs to guess structure. Parameter descriptions are present but often generic (e.g., 'PID of the scsynth/supernova process' repeated 8 times). Error handling is absent, tools return strings with no guidance on failure modes, retryability, or recovery steps. No input validation constraints (enums, ranges) visible. Security concerns: WRITE tools lack confirmation/dry-run patterns and permission gates. Composition is reasonable (single responsibility per tool), but many tools return opaque string responses rather than structured JSON.
Answer a SuperCollider question grounded in local indexed docs with evidence snippets.
Compile-check sclang code with sclang without executing it or producing audio.
Detect SuperCollider installation and executable paths on this machine (sclang/scsynth/supernova).
High-fidelity SuperCollider discovery: process inventory, OSC probe results across candidate ports, install matching, and machine-friendly JSON.
TRUSTED HOST ONLY: Ensure SuperCollider app/runtime is ON (scide/sclang). Optionally boots/reuses the audio server.
TRUSTED HOST ONLY: Execute sclang code against the live scsynth server. Use this to play sounds, create synths, etc. The code runs inside a Server.remote session.
No output schemas documented for any tool. All 16 tools return strings with no declared structure. LLMs cannot plan downstream calls or extract typed fields.
No error handling guidance. Tools return strings but do not indicate success/failure, retryability, or recovery steps. LLMs cannot distinguish transient failures from permanent errors.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
TRUSTED HOST ONLY: Diagnose 'server is up but no sound' issues. Returns current control target, /status.reply metrics, and tracked scsynth log tail when available.
Return local SuperCollider documentation paths (if installed) and key online docs links.
Get OSC reachability, CPU/memory, and uptime for a specific server PID or auto-pick active server.
List running SuperCollider server processes (scsynth/supernova) with PID, CPU, memory, candidate OSC ports, responding OSC port, and install-path match status.
List all SuperCollider-related process candidates (scsynth/supernova/sclang/scide) including PID, executable path, and command line for debugging.
Quick SuperCollider health check: scans scsynth/supernova/sclang processes, probes OSC /status on likely ports, and reports install detection.
TRUSTED HOST ONLY: Play a short deterministic sine test tone on the live server. Use this to verify that audio output actually works before running complex snippets.
TRUSTED HOST ONLY: OSC /quit then respawn scsynth/supernova with -u <port>.
Search local SuperCollider docs with synonym expansion and ranked results.
TRUSTED HOST ONLY: Run Server.default.freeAll to silence all synths on the target server.
WRITE tools (execute_supercollider_code, play_test_tone, ensure_supercollider_app_on, stop_supercollider_synths, reboot_supercollider_server) lack confirmation/dry-run patterns. No permission gates. Agents can execute irreversible audio operations without safeguards.
Parameter descriptions are generic and repetitive. 'PID of the scsynth/supernova process; omit to auto-detect' appears 8 times. No constraints (ranges, enums, formats) documented. LLMs cannot validate inputs before calling.
Discovery tools (get_servers, discover_supercollider, list_server_candidates) do not document pagination, result limits, or when to call each variant. No guidance on which discovery tool to use first.