mcp-svstudio

Instructions

Implementation Reference

• src/index.ts:493-544 (handler)

  Handler for the 'edit_notes' MCP tool. Validates trackId and notes array, maps note properties to numbers/strings, executes the 'edit_notes' command via file-based IPC to Synthesizer V Studio Lua script, and returns success message or error.
  case "edit_notes": { const args = request.params.arguments as any; const trackId = Number(args.trackId); if (isNaN(trackId)) { return { content: [{ type: "text", text: "Error: Invalid track ID" }], isError: true }; } if (!Array.isArray(args.notes) || args.notes.length === 0) { return { content: [{ type: "text", text: "Error: No notes provided" }], isError: true }; } const result = await executeCommand("edit_notes", { trackId, notes: args.notes.map((note: any) => ({ id: Number(note.id), lyrics: note.lyrics && String(note.lyrics), startTime: note.startTime && Number(note.startTime), duration: note.duration && Number(note.duration), pitch: note.pitch && Number(note.pitch) })) }); if (result.error) { return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true }; } return { content: [{ type: "text", text: result.message || `${args.notes.length} notes edited successfully` }] }; }
• src/index.ts:331-373 (registration)

  Registration of the 'edit_notes' tool in the ListToolsRequestSchema handler, including name, description, and detailed input schema defining trackId and array of notes with required id and optional lyrics, startTime, duration, pitch.
  name: "edit_notes", description: "Edit one or more notes", inputSchema: { type: "object", properties: { trackId: { type: "string", description: "ID of the track" }, notes: { type: "array", description: "Array of notes to edit", items: { type: "object", properties: { id: { type: "number", description: "The ID of the note" }, lyrics: { type: "string", description: "Lyrics text for the note" }, startTime: { type: "number", description: "Start time in ticks" }, duration: { type: "number", description: "Duration in ticks" }, pitch: { type: "number", description: "MIDI pitch (0-127)" } }, required: ["id"] } } }, required: ["trackId", "notes"] } },
• src/index.ts:76-84 (helper)

  Generic helper function used by all tools, including 'edit_notes', to serialize command to JSON file and poll for response from Synthesizer V Studio Lua script.
  async function executeCommand(action: string, params: any = {}): Promise<any> { const command = { action, ...params }; await writeCommand(command); return await readResponse(); }