Guía de Integración de Suno MCP

MCP (Modelo Context Protocol) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a los modelos de IA (como Claude, GPT, etc.) invocar herramientas externas a través de interfaces estandarizadas. A través del Suno MCP Server proporcionado por AceData Cloud, puedes generar música, letras y gestionar proyectos de audio directamente en clientes de IA como Claude Desktop, VS Code, Cursor, entre otros.

Resumen de Funciones

Suno MCP Server ofrece las siguientes funciones clave:

Generación de música — Generar música AI a través de indicaciones de texto
Creación personalizada — Control total sobre letras, títulos y estilos musicales
Continuación de canciones — Extender canciones existentes desde cualquier punto en el tiempo
Versiones de covers/remixes — Crear versiones de covers en diferentes estilos
Generación de letras — Generar letras estructuradas según la descripción
Voces de personajes — Guardar y reutilizar estilos de voz
Conversión de medios — Obtener MP4, WAV, MIDI, separación de voces, etc.
Optimización de estilo — Optimizar etiquetas de estilo musical
Consulta de tareas — Monitorear el progreso de generación y obtener resultados

Preparativos Previos

Antes de usar, necesitas obtener el Token de API de AceData Cloud:

Regístrate o inicia sesión en la plataforma AceData Cloud
Ve a la página de Suno Audios API
Haz clic en “Acquire” para obtener el Token de API (se ofrece un crédito gratuito en la primera solicitud)

Instalación y Configuración

Método 1: Instalación con pip (recomendado)

pip install mcp-suno

Método 2: Instalación desde el código fuente

git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
pip install -e .

Una vez completada la instalación, puedes usar el comando mcp-suno para iniciar el servicio.

Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega la siguiente configuración:

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

Si usas uvx (sin necesidad de instalar paquetes previamente):

{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

Guarda la configuración y reinicia Claude Desktop para poder usar las herramientas relacionadas con Suno en la conversación.

Uso en VS Code / Cursor

Crea un archivo .vscode/mcp.json en el directorio raíz del proyecto:

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

O usa uvx:

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "tu Token de API"
      }
    }
  }
}

Lista de Herramientas Disponibles

Nombre de la herramienta	Descripción
`suno_generate_music`	Generar música a través de indicaciones de texto
`suno_generate_custom_music`	Generar música con letras y estilos personalizados
`suno_extend_music`	Continuar canciones desde un punto específico
`suno_cover_music`	Crear versiones de covers
`suno_concat_music`	Concatenar fragmentos de canciones
`suno_generate_with_persona`	Generar música usando voces de personajes especificados
`suno_remaster_music`	Re-masterizar música
`suno_stems_music`	Separar pistas (voces/acompañamiento)
`suno_replace_section`	Reemplazar secciones específicas en una canción
`suno_upload_extend`	Subir audio y continuar escribiendo
`suno_upload_cover`	Subir audio y hacer un cover
`suno_mashup_music`	Mezclar varias canciones
`suno_generate_lyrics`	Generar letras según la descripción
`suno_create_persona`	Crear voces de personajes
`suno_get_mp4`	Obtener video MP4 de la canción
`suno_get_timing`	Obtener la línea de tiempo de las letras
`suno_extract_vocals`	Extraer voces
`suno_get_wav`	Obtener WAV de alta calidad
`suno_get_midi`	Obtener archivos MIDI
`suno_optimize_style`	Optimizar etiquetas de estilo musical
`suno_mashup_lyrics`	Mezclar letras
`suno_upload_audio`	Subir audio personalizado
`suno_get_task`	Consultar el estado de una tarea
`suno_get_tasks_batch`	Consultar el estado de tareas en lote

Ejemplos de Uso

Una vez configurado, puedes invocar estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:

“Ayúdame a generar una canción pop sobre el verano”
“Haz un cover de esta canción en estilo jazz”
“Continúa esta canción desde el segundo 30”
“Genera una letra en chino, el tema es viaje”
“Separa la voz de esta canción”
“Ayúdame a convertir esta canción a formato MIDI”

Más Información

Repositorio de GitHub: AceDataCloud/SunoMCP
Paquete de PyPI: mcp-suno
Documentación de la API: API de generación de música Suno

​Resumen de Funciones

​Preparativos Previos

​Instalación y Configuración

​Método 1: Instalación con pip (recomendado)

​Método 2: Instalación desde el código fuente

​Uso en Claude Desktop

​Uso en VS Code / Cursor

​Lista de Herramientas Disponibles

​Ejemplos de Uso

​Más Información