Suno MCP

Un servidor MCP (Model Context Protocol) para generar música con Suno.

Características

• Generar canciones con letras personalizadas y etiquetas de estilo

• Generar a partir de una descripción - deja que la IA de Suno escriba la letra

• Esperar a que se completen y obtener URLs de audio con incrustaciones de markdown

• Descargar MP3s a carpetas locales

• Actualización automática de tokens cuando caducan

Related MCP server: Suno-MCP

Requisitos

• Node.js 18+

• BrowserOS (o cualquier Chromium con --remote-debugging-port) en http://localhost:9100 con la sesión de Suno iniciada. Se puede sobrescribir con CDP_URL.

• Una cuenta de Suno (gratuita o de pago)

Instalación

npm install

Uso con Claude Code

Añadir a tu .mcp.json:

{
  "suno": {
    "command": "node",
    "args": ["/path/to/suno-mcp/src/index.js"]
  }
}

Herramientas

Cómo funciona

Autenticación

Suno utiliza Clerk para la autenticación con tokens JWT de corta duración. El cliente llama a window.Clerk.session.getToken() en la pestaña activa de Suno a través de CDP; Clerk gestiona la actualización en segundo plano, por lo que no es necesario recargar la página. El token se almacena en caché hasta 5 minutos antes de su reclamación exp.

Generación de canciones

Las llamadas directas a la API fallan debido a hCaptcha. En lugar de extraer selectores de formularios, el cliente controla la propia aplicación React de Suno:

1. Conectar a la pestaña de Suno a través de CDP; navegar a /create si es necesario.

2. Recorrer el árbol de fibras de React desde el botón Crear para encontrar el componente que expone onCreateClick / lyrics / styles / mode como props (el manejador de generación semántica).

3. Rellenar las áreas de texto de letra y estilo usando el setter nativo compatible con React para que el estado interno se actualice.

4. Esperar hasta que las props de la fibra reflejen los nuevos valores (es decir, que React se haya vuelto a renderizar).

5. Despachar un clic de ratón de confianza a través de Input.dispatchMouseEvent de CDP en las coordenadas del botón. hCaptcha acepta eventos sintetizados por CDP como gestos de usuario reales (llamar a onCreateClick() desde JS no funciona, el captcha lo rechaza).

6. Capturar la respuesta de /api/generate/v2 a través de eventos Network de CDP para devolver los nuevos IDs de clip. Si se pierde el evento de red, recurre al sondeo de /api/project/default.

Este enfoque es robusto ante rediseños de la interfaz de usuario: depende de props semánticas de React (onCreateClick, lyrics, styles) y del botón aria-label="Create song" (ambos elementos fundamentales y con pocas probabilidades de cambiar), en lugar de nombres de clase, coincidencias de textContent o diseño DOM.

Ejemplo

// Generate a song
const result = await suno_generate_song({
  lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test",
  style: "indie folk, acoustic, male vocals"
});

// Wait for it to complete
const songs = await suno_wait_for_songs({
  ids: result.songIds
});

// Download it
await suno_download_song({
  songId: songs[0].id,
  folder: "./downloads"
});

Limitaciones conocidas

• El campo de título no funciona de forma fiable (limitación de la interfaz de usuario de Suno, actualmente no está conectado a través de la nueva ruta de generación).

• generate_from_description (modo simple) actualmente vuelve al modo personalizado si no se encuentra el interruptor de modo de la interfaz; pasa la letra y el estilo a través de generate_song para un comportamiento determinista.

• Requiere BrowserOS con una sesión de Suno activa y visible. El botón Crear debe tener un tamaño distinto de cero en la pantalla para que el clic de confianza se registre.

• El token caduca aproximadamente cada 1 hora (se actualiza automáticamente a través de Clerk).

Licencia

MIT