MusicGPT MCP Server

Instructions

Implementation Reference

• src/index.ts:1035-1054 (handler)

  The handler function that implements the core logic for the 'convert_audio_format' tool. It validates inputs, makes an API call to '/fileconvert' endpoint of MusicGPT API, and returns the task details with instructions for status checking.

  private async handleConvertAudioFormat(args: any) {
    if (!args.audio_url || !args.output_format) {
      throw new McpError(ErrorCode.InvalidParams, "audio_url and output_format are required");
    }
  
    const response = await this.axiosInstance.post("/fileconvert", {
      audio_url: args.audio_url,
      output_format: args.output_format,
      webhook_url: args.webhook_url,
    });
  
    return {
      content: [
        {
          type: "text",
          text: `Audio format conversion started!\n\n${JSON.stringify(response.data, null, 2)}\n\nUse get_conversion_by_id with the task_id to check the status.`,
        },
      ],
    };
  }

• src/index.ts:334-356 (schema)

  The tool definition in the TOOLS array, including name, description, and detailed inputSchema with properties and requirements for the 'convert_audio_format' tool.

  {
    name: "convert_audio_format",
    description: "Convert audio file to a different format",
    inputSchema: {
      type: "object" as const,
      properties: {
        audio_url: {
          type: "string",
          description: "URL of the audio file to convert",
        },
        output_format: {
          type: "string",
          description: "Desired output format",
          enum: ["mp3", "wav", "flac", "ogg", "m4a"],
        },
        webhook_url: {
          type: "string",
          description: "URL for callback upon completion",
        },
      },
      required: ["audio_url", "output_format"],
    },
  },

• src/index.ts:695-696 (registration)

  The switch case in the CallToolRequestSchema handler that registers and routes calls to the 'convert_audio_format' tool to its handler method.

  case "convert_audio_format":
    return await this.handleConvertAudioFormat(args);