mcp-svstudio

Instructions

Implementation Reference

• src/index.ts:441-491 (handler)

  MCP CallToolRequestSchema handler case for 'add_notes': validates and sanitizes input (trackId as number, notes array non-empty, map to string/number), calls executeCommand('add_notes'), returns formatted text response or error.
  case "add_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("add_notes", { trackId, notes: args.notes.map((note: any) => ({ lyrics: String(note.lyrics), startTime: Number(note.startTime), duration: Number(note.duration), 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 added successfully` }] }; }
• src/index.ts:277-314 (schema)

  Tool definition including name, description, and inputSchema for 'add_notes' returned by ListToolsRequestSchema handler (serves as registration). Defines required trackId (string) and notes array of objects with lyrics, startTime, duration, pitch.
  name: "add_notes", description: "Add one or more notes to a track", inputSchema: { type: "object", properties: { trackId: { type: "string", description: "ID of the track" }, notes: { type: "array", description: "Array of notes to add", items: { type: "object", properties: { 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: ["lyrics", "startTime", "duration", "pitch"] } } }, required: ["trackId", "notes"] }
• src/index.ts:76-84 (helper)

  Generic helper function invoked by the add_notes handler to dispatch the command to Synthesizer V Studio by writing JSON {action: 'add_notes', trackId, notes} to COMMAND_FILE and polling RESPONSE_FILE for result.
  async function executeCommand(action: string, params: any = {}): Promise<any> { const command = { action, ...params }; await writeCommand(command); return await readResponse(); }