mcp-svstudio

Instructions

Implementation Reference

• src/index.ts:546-571 (handler)

  MCP callTool handler for 'add_track': extracts optional track name, invokes executeCommand to add track via IPC to Lua script, handles response with success message including new track ID or error.

  case "add_track": {
    const args = request.params.arguments as any;
  
    const params: any = {
      name: args.name || "New Track"
    };
  
    const result = await executeCommand("add_track", params);
  
    if (result.error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${result.error}`
        }],
        isError: true
      };
    }
  
    return {
      content: [{
        type: "text",
        text: result.message || `Track "${params.name}" added successfully with ID ${result.trackId}`
      }]
    };
  }

• src/index.ts:316-329 (schema)

  Schema and registration for 'add_track' tool: defines name, description, and optional 'name' string parameter in listTools response.

  {
    name: "add_track",
    description: "Add a new track to the project",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Name of the new track"
        }
      },
      required: []
    }
  },

• src/index.ts:76-84 (helper)

  Helper function executeCommand(action, params) used by the add_track handler to serialize command to JSON file for Lua script consumption and await/parse response.

  async function executeCommand(action: string, params: any = {}): Promise<any> {
    const command = {
      action,
      ...params
    };
  
    await writeCommand(command);
    return await readResponse();
  }