> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de Integración de Suno MCP

> suno MCP 服务器集成

[MCP (Modelo Context Protocol)](https://modelcontextprotocol.io) 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 XHuoAPI, 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 XHuoAPI:

1. Regístrate o inicia sesión en [la plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Ve a la página de [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios)
3. 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)

```bash theme={null}
pip install mcp-suno
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "tu Token de API"
      }
    }
  }
}
```

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

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "tu Token de API"
      }
    }
  }
}
```

O usa `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* Paquete de PyPI: [mcp-suno](https://pypi.org/project/mcp-suno/)
* Documentación de la API: [API de generación de música Suno](https://api.xhuoapi.ai/documents/suno)