SuperCollider MCP Server

Instructions

Implementation Reference

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

  The handler case for 'sc_record_start' tool. It validates the filename input using Zod, checks if the SuperCollider server is booted, generates SuperCollider code to start recording to 'recordings/{filename}', executes it via scServer, and returns a success message.

  case 'sc_record_start': {
    const schema = z.object({ filename: z.string() });
    const { filename } = schema.parse(args);
  
    if (!scServer.getBooted()) {
      return {
        content: [{ type: 'text', text: 'Error: SuperCollider server is not running. Call sc_boot first.' }],
        isError: true,
      };
    }
  
    const code = `Server.default.record("recordings/${filename}");`;
    await scServer.executeCode(code);
  
    return {
      content: [{ type: 'text', text: `Started recording to recordings/${filename}` }],
    };
  }

• src/index.ts:167-180 (registration)

  Registration of the 'sc_record_start' tool in the tools array, including its name, description, and input schema definition for filename.

  {
    name: 'sc_record_start',
    description: 'Start recording audio output to a file',
    inputSchema: {
      type: 'object',
      properties: {
        filename: {
          type: 'string',
          description: 'Output filename (will be saved in recordings/ directory)',
        },
      },
      required: ['filename'],
    },
  },

• src/index.ts:170-178 (schema)

  Input schema definition for the 'sc_record_start' tool, specifying the required 'filename' string parameter.

  inputSchema: {
    type: 'object',
    properties: {
      filename: {
        type: 'string',
        description: 'Output filename (will be saved in recordings/ directory)',
      },
    },
    required: ['filename'],