MCP MiniMax Music Server

Geração de áudio com inteligência artificial usando a API MiniMax Music.

GitHub
5
Experimente este MCPPatrocinado

Documentação

Servidor MCP MiniMax Music

Version License

Uma implementação de servidor Model Context Protocol (MCP) para geração de áudio com IA usando a API MiniMax Music. Desenvolvido por Falah.G.Salieh.

📋 Sumário

🎯 Visão Geral

Este servidor MCP permite que agentes de IA gerem conteúdo de música e áudio usando a API MiniMax Music através do Model Context Protocol. Ele fornece integração perfeita com hosts MCP como o Claude Desktop, permitindo que agentes de IA criem música e áudio com base em prompts de texto.

✨ Recursos

  • Geração de música com IA
  • Suporte ao modelo MiniMax Music
  • Processo de geração em duas etapas com verificação de status
  • Integração perfeita com o Claude Desktop
  • Suporte a variáveis de ambiente para chaves de API
  • Tratamento detalhado de erros e relatórios

🔧 Pré-requisitos

  • Node.js (v16 ou superior)
  • TypeScript (v5.3.3 ou superior)
  • Claude Desktop (versão mais recente)
  • Chave de API AIML
  • Sistema operacional Windows/Linux/macOS

📦 Instalação

  1. Clone o repositório:

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

  2. Instale as dependências:

    npm install

  3. Compile o servidor:

    npm run build

⚙️ Configuração

Configuração do Claude Desktop

  1. Localize o arquivo de configuração do 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. Adicione a seguinte configuração:

    {
  "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:

    • Substitua o caminho pelo caminho real do seu servidor
    • Adicione o prefixo "Bearer " à sua chave de API
    • Use barras invertidas duplas em caminhos do Windows

Configuração da Chave de API

Sua chave de API AIML pode ser configurada de duas maneiras:

  1. Variáveis de Ambiente (Recomendado)

    • Defina na configuração do Claude Desktop conforme mostrado acima
    • Prefixe com "Bearer " (incluindo o espaço)
    • Exemplo: "AIML_API_KEY": "Bearer 3d90d64a000c4e6eb02df7e52d2166d2"

  2. Configuração Direta

    • Passe a chave de API diretamente na solicitação de geração
    • Menos seguro, mas útil para testes

🚀 Uso

Uso Básico

O servidor fornece uma ferramenta chamada generate_audio com os seguintes parâmetros:

  • prompt (obrigatório): Prompt de texto para geração de áudio
  • model (opcional): Defina como "minimax-music"
  • reference_audio_url (opcional): URL do áudio de referência
  • generation_id (opcional): ID da geração anterior para verificação de status

Exemplos de Comandos

  1. Iniciar nova geração:

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

  2. Verificar status da geração:

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

Formato de Resposta

{
  "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
    }
  }
}

📚 Referência da API

Modelo MiniMax Music

O servidor usa o modelo MiniMax Music que:

  • É especializado em geração de música
  • Requer áudio de referência para correspondência de estilo
  • Suporta geração de letras com delimitadores ##
  • Gera saída musical de alta qualidade

Processo de Geração

  1. Etapa 1: Enviar Geração

    • Envie o prompt e os parâmetros
    • Receba o ID da geração

  2. Etapa 2: Verificar Status

    • Consulte o status usando o ID da geração
    • Baixe o áudio quando concluído

🔍 Solução de Problemas

Problemas Comuns

  1. Erros de Autenticação (401)

    • Verifique o formato da chave de API (deve começar com "Bearer ")
    • Verifique a validade da chave de API
    • Garanta a configuração correta em claude_desktop_config.json

  2. Problemas de Caminho

    • Use o formato de caminho correto para seu sistema operacional
    • Windows: Use barras invertidas duplas
    • Verifique se o diretório de compilação existe

  3. Erros de Geração

    • Verifique o formato do prompt (deve estar entre ##...## para letras)
    • Garanta que a URL do áudio de referência esteja acessível
    • Verifique o comprimento e o conteúdo do prompt

Etapas de Depuração

  1. Recompile o servidor:

    npm run build

  2. Reinicie o Claude Desktop

  3. Verifique os logs do servidor para erros

🤝 Contribuição

  1. Faça um fork do repositório
  2. Crie sua branch de recurso
  3. Faça commit das suas alterações
  4. Envie para a branch
  5. Crie um Pull Request

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes

👤 Autor

Falah.G.Salieh

  • Localização: Bagdá, Iraque
  • Função: Desenvolvedor e Especialista em Integração de IA
  • Ano: 2025

🌟 Suporte

Precisa de ajuda? Veja como obter suporte:

  1. Consulte a seção de solução de problemas
  2. Abra uma issue no repositório
  3. Entre em contato diretamente com o autor

Este projeto faz parte do ecossistema Model Context Protocol, permitindo integração perfeita entre agentes de IA e serviços externos.