mcp-svstudio

Instructions

Implementation Reference

• src/index.ts:407-439 (handler)

  MCP tool handler for 'get_track_notes'. Validates the trackId from arguments, calls executeCommand to fetch notes from Synthesizer V Studio via file communication, handles errors, and returns notes as JSON text.

  case "get_track_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
      };
    }
  
    const notes = await executeCommand("get_track_notes", { trackId });
  
    if (notes.error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${notes.error}`
        }],
        isError: true
      };
    }
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify(notes, null, 2)
      }]
    };
  }

• src/index.ts:262-275 (registration)

  Tool registration in the list_tools handler, defining the name, description, and input schema requiring trackId.

  {
    name: "get_track_notes",
    description: "Get all notes in a specific track",
    inputSchema: {
      type: "object",
      properties: {
        trackId: {
          type: "string",
          description: "ID of the track"
        }
      },
      required: ["trackId"]
    }
  },

• src/index.ts:265-274 (schema)

  Input schema definition for get_track_notes tool, specifying trackId as required string.

  inputSchema: {
    type: "object",
    properties: {
      trackId: {
        type: "string",
        description: "ID of the track"
      }
    },
    required: ["trackId"]
  }