MCP MiniMax Music Server

Generación de audio impulsada por IA usando la API de MiniMax Music.

GitHub
5

Documentación

Servidor MCP MiniMax Music

Version License

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para la generación de audio impulsada por IA utilizando la API de Música MiniMax. Desarrollado por Falah.G.Salieh.

📋 Tabla de Contenidos

🎯 Descripción General

Este servidor MCP permite a los agentes de IA generar contenido de música y audio utilizando la API de Música MiniMax a través del Protocolo de Contexto de Modelo. Proporciona una integración perfecta con hosts MCP como Claude Desktop, permitiendo a los agentes de IA crear música y audio basados en indicaciones de texto.

✨ Características

  • Generación de música impulsada por IA
  • Soporte para el modelo de Música MiniMax
  • Proceso de generación en dos pasos con verificación de estado
  • Integración perfecta con Claude Desktop
  • Soporte de variables de entorno para claves API
  • Manejo detallado de errores y reportes

🔧 Requisitos Previos

  • Node.js (v16 o superior)
  • TypeScript (v5.3.3 o superior)
  • Claude Desktop (última versión)
  • Clave API de AIML
  • Sistema operativo Windows/Linux/macOS

📦 Instalación

  1. Clona el repositorio:

    git clone https://github.com/yourusername/mcp-minimax-music-server.git
cd mcp-minimax-music-server

  2. Instala las dependencias:

    npm install

  3. Compila el servidor:

    npm run build

⚙️ Configuración

Configuración de Claude Desktop

  1. Localiza tu archivo de configuración de Claude Desktop:

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

  2. Agrega la siguiente configuración:

    {
  "mcpServers": {
    "minimax-music-server": {
      "command": "node",
      "args": [
        "G:\\mcp-minimax-music-server\\build\\index.js"
      ],
      "env": {
        "AIML_API_KEY": "Bearer your-aiml-api-key-here"
      }
    }
  }
}

    ⚠️ Importante:

    • Reemplaza la ruta con la ruta real de tu servidor
    • Agrega el prefijo "Bearer " a tu clave API
    • Usa dobles barras invertidas en rutas de Windows

Configuración de la Clave API

Tu clave API de AIML se puede configurar de dos maneras:

  1. Variables de Entorno (Recomendado)

    • Configúrala en la configuración de Claude Desktop como se muestra arriba
    • Prefijo con "Bearer " (incluye el espacio)
    • Ejemplo: "AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"

  2. Configuración Directa

    • Pasa la clave API directamente en la solicitud de generación
    • Menos seguro, pero útil para pruebas

🚀 Uso

Uso Básico

El servidor proporciona una herramienta llamada generate_audio con los siguientes parámetros:

  • prompt (obligatorio): Indicación de texto para la generación de audio
  • model (opcional): Configúralo en "minimax-music"
  • reference_audio_url (opcional): URL del audio de referencia
  • generation_id (opcional): ID de una generación anterior para verificar el estado

Ejemplos de Comandos

  1. Iniciar nueva generación:

    Generate audio with prompt "Create a romantic love song with gentle acoustic guitar and soft vocals"

  2. Verificar estado de generación:

    Generate audio with generation_id "abc123" and prompt "Check status"

Formato de Respuesta

{
  "toolResult": {
    "status": "completed",
    "id": "generation-id",
    "audio_file": {
      "url": "https://cdn.example.com/audio.mp3",
      "content_type": "audio/mpeg",
      "file_name": "output.mp3",
      "file_size": 1024000
    }
  }
}

📚 Referencia de la API

Modelo de Música MiniMax

El servidor utiliza el modelo de Música MiniMax que:

  • Se especializa en la generación de música
  • Requiere audio de referencia para coincidencia de estilo
  • Soporta generación de letras con delimitadores ##
  • Genera salida musical de alta calidad

Proceso de Generación

  1. Paso 1: Enviar Generación

    • Envía la indicación y los parámetros
    • Recibe el ID de generación

  2. Paso 2: Verificar Estado

    • Consulta el estado usando el ID de generación
    • Descarga el audio cuando esté completo

🔍 Solución de Problemas

Problemas Comunes

  1. Errores de Autenticación (401)

    • Verifica el formato de la clave API (debe comenzar con "Bearer ")
    • Comprueba la validez de la clave API
    • Asegúrate de que la configuración sea correcta en claude_desktop_config.json

  2. Problemas de Ruta

    • Usa el formato de ruta correcto para tu sistema operativo
    • Windows: Usa dobles barras invertidas
    • Verifica que exista el directorio de compilación

  3. Errores de Generación

    • Verifica el formato de la indicación (debe estar envuelta en ##...## para letras)
    • Asegúrate de que la URL del audio de referencia sea accesible
    • Verifica la longitud y el contenido de la indicación

Pasos de Depuración

  1. Recompila el servidor:

    npm run build

  2. Reinicia Claude Desktop

  3. Revisa los registros del servidor para ver errores

🤝 Contribuciones

  1. Haz un fork del repositorio
  2. Crea tu rama de características
  3. Realiza tus cambios
  4. Haz push a la rama
  5. Crea una Solicitud de Extracción

📄 Licencia

Licencia MIT - consulta el archivo LICENCIA para más detalles

👤 Autor

Falah.G.Salieh

  • Ubicación: Bagdad, Irak
  • Rol: Desarrollador y Especialista en Integración de IA
  • Año: 2025

🌟 Soporte

¿Necesitas ayuda? Así puedes obtener soporte:

  1. Consulta la sección de solución de problemas
  2. Abre un problema en el repositorio
  3. Contacta directamente al autor

Este proyecto es parte del ecosistema del Protocolo de Contexto de Modelo, permitiendo una integración perfecta entre agentes de IA y servicios externos.