Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.
//
// Base for every MCP tool group: holds the shared engine + dispatch + refresh, and gives two
// helpers so a tool body stays one line — Read (query on the UI thread) and Mutate (edit on the
// UI thread, then refresh the UI). Exceptions are turned into a readable string rather than
// thrown across the transport. A Mutate is one undo group, so a tool call undoes as one step
// whatever it changed (specs/016); parameter writes go through DevParam / MidiParam /
// PlugParam so a plain value change lands in that step too.
using Nota.Application;
using Nota.Application.Editing;
namespace Nota.Mcp;
public abstract class EngineTools(IAudioEngine engine, IEngineDispatch dispatch, IArrangementRefresh refresh)
{
protected readonly IAudioEngine E = engine;
private readonly IEngineDispatch _d = dispatch;
private readonly IArrangementRefresh _r = refresh;
/// <summary>Run a read on the engine's UI thread and return the value.</summary>
protected Task<T> Read<T>(Func<T> func) => _d.InvokeAsync(func);
/// <summary>Run an edit on the UI thread, then refresh the arrangement/device panel.</summary>
protected Task Mutate(Action action) => _d.InvokeAsync(() =>
{
E.BeginUndoGroup();
try { action(); }
finally { E.EndUndoGroup(); }
_r.Refresh();
});
/// <summary>Run an edit that returns a value on the UI thread, then refresh.</summary>
protected Task<T> Mutate<T>(Func<T> func) => _d.InvokeAsync(() =>
{
T v;
E.BeginUndoGroup();
try { v = func(); }
finally { E.EndUndoGroup(); }
_r.Refresh();
return v;
});
/// <summary>Set a built-in audio effect's parameter as an undoable value change.</summary>
protected void DevParam(int trackId, int deviceIndex, int paramIndex, float value)
=> MixEdit.Step(E, () => E.DeviceSetParam(trackId, deviceIndex, paramIndex, value), MixTarget.DeviceParam(trackId, deviceIndex, paramIndex));
/// <summary>Set a MIDI effect's parameter as an undoable value change.</summary>
protected void MidiParam(int trackId, int index, int paramIndex, float value)
=> MixEdit.Step(E, () => E.MidiEffectSetParam(trackId, index, paramIndex, value), MixTarget.MidiDeviceParam(trackId, index, paramIndex));
/// <summary>Set a normalized plug-in / instrument parameter (deviceIndex -1 = the instrument)
/// as an undoable value change.</summary>
protected void PlugParam(int trackId, int deviceIndex, int paramIndex, float value)
=> MixEdit.Step(E, () => E.PluginParamSet(trackId, deviceIndex, paramIndex, value), MixTarget.PluginParam(trackId, deviceIndex, paramIndex));
/// <summary>Resolve a track id to its enumeration index (0..TrackCount-1), or -1. UI thread.</summary>
protected int IndexOfTrack(int trackId)
{
int n = E.TrackCount;
for (int i = 0; i < n; i++) if (E.TryGetTrackInfo(i, out var ti) && ti.Id == trackId) return i;
return -1;
}
protected static string TypeName(int type) => type switch { 1 => "instrument", 2 => "return", 3 => "group", _ => "audio" };
}