AquaSynth/tools/AquaSynthDingsMcp/README.md
2026-08-21 21:00:57 +02:00

1.6 KiB

AquaSynth Dings MCP

Stdio MCP bridge for synthesized agent notifications. Event motif says what happened; curated instrument timbre says which agent spoke.

All MCP instances are command bridges. One persistent AquaSynthDingsHost.exe owns the WASAPI session named AquaSynth Dings, the Aqua synthesis child, mixer, master volume, and mute state. Windows Volume Mixer and MCP volume tools address the same session.

Do not register this STDIO bridge globally in an agent harness that creates a separate MCP client for every root agent, subagent, or critic. STDIO ownership means one resident .NET bridge per client even though audio authority is already shared by AquaSynthDingsHost.exe. Keep the bridge disabled in that topology, use the direct CLI for local smokes, or expose one supervised Streamable HTTP MCP server when notifications need to be available across many concurrent agents.

dotnet run --project tools/AquaSynthDingsMcp

Direct smokes and controls:

dotnet run --project tools/AquaSynthDingsMcp -- --play task.complete warm-bell
dotnet run --project tools/AquaSynthDingsMcp -- --get-volume
dotnet run --project tools/AquaSynthDingsMcp -- --set-volume 0.5
dotnet run --project tools/AquaSynthDingsMcp -- --mute true

MCP tools are play_ding, list_ding_events, list_instruments, stop_dings, get_volume, set_volume, and mute_dings.

Instrument availability is catalog-only. Additions must satisfy mechanical curation checks and then survive listening/identification tests; see docs/research/auditory-notifications/README.md.