MiniMax MCP Server

Servidor oficial MiniMax Model Context Protocol (MCP) que permite a interação com poderosas APIs de Texto para Fala e geração de vídeo/imagem. Este servidor possibilita que clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents e outros gerem fala, clonem vozes, gerem vídeo, gerem imagem e muito mais.

💡 Recomendado: MiniMax CLI (mmx-cli) — nossa ferramenta oficial de linha de comando com os modelos mais recentes e recursos adicionais, incluindo texto, visão, busca e cover musical. Funciona como uma habilidade de agente de IA para Claude Code, Cursor, OpenClaw, etc.

Documentação

• 中文文档
• MiniMax-MCP-JS - Implementação oficial em JavaScript do MiniMax MCP

Início Rápido com Cliente MCP

1. Obtenha sua chave de API em MiniMax.
2. Instale o uv (gerenciador de pacotes Python), instale com curl -LsSf https://astral.sh/uv/install.sh | sh ou veja o repositório do uv para métodos de instalação adicionais.
3. Importante: O host e a chave da API variam por região e devem corresponder; caso contrário, você encontrará um erro Invalid API key.

Região	Global	China Continental
MINIMAX_API_KEY	obtenha em MiniMax Global	obtenha em MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Vá para Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir o seguinte:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ Aviso: A chave de API precisa corresponder ao host. Se ocorrer um erro "API Error: invalid api key", verifique seu host de API:

• Host Global：https://api.minimax.io
• Host China Continental：https://api.minimaxi.com

Se você estiver usando Windows, será necessário habilitar o "Modo Desenvolvedor" no Claude Desktop para usar o servidor MCP. Clique em "Ajuda" no menu hambúrguer no canto superior esquerdo e selecione "Habilitar Modo Desenvolvedor".

Cursor

Vá para Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server para adicionar a configuração acima.

Pronto. Seu cliente MCP agora pode interagir com o MiniMax através destas ferramentas:

Transporte

Suportamos dois tipos de transporte: stdio e sse.

stdio	SSE
Executa localmente	Pode ser implantado localmente ou na nuvem
Comunicação via stdout	Comunicação via network
Entrada: Suporta processamento de local files ou recursos URL válidos	Entrada: Quando implantado na nuvem, recomenda-se usar URL para entrada

Ferramentas Disponíveis

ferramenta	descrição
text_to_audio	Converte texto em áudio com uma determinada voz
list_voices	Lista todas as vozes disponíveis
voice_clone	Clona uma voz usando arquivos de áudio fornecidos
generate_video	Gera um vídeo a partir de um prompt
text_to_image	Gera uma imagem a partir de um prompt
query_video_generation	Consulta o resultado da tarefa de geração de vídeo
music_generation	Gera uma faixa de música a partir de um prompt e letra
voice_design	Gera uma voz a partir de um prompt usando texto de pré-visualização

Notas de Lançamento

2 de julho de 2025

🆕 Novidades

• Design de Voz: Nova ferramenta voice_design - crie vozes personalizadas a partir de prompts descritivos com áudio de pré-visualização
• Aprimoramento de Vídeo: Adicionado modelo MiniMax-Hailuo-02 com qualidade ultra-nítida e controles de duração/resolução
• Geração de Música: Ferramenta music_generation aprimorada, alimentada pelo modelo music-1.5

📈 Ferramentas Aprimoradas

• voice_design - Gera vozes personalizadas a partir de descrições de texto
• generate_video - Agora suporta MiniMax-Hailuo-02 com opções de duração de 6s/10s e resolução de 768P/1080P
• music_generation - Criação de música de alta qualidade com o modelo music-1.5

Perguntas Frequentes

1. invalid api key

Certifique-se de que sua chave de API e host de API estejam alinhados regionalmente

Região	Global	China Continental
MINIMAX_API_KEY	obtenha em MiniMax Global	obtenha em MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Confirme seu caminho absoluto executando este comando no seu terminal:

which uvx

Assim que obtiver o caminho absoluto (ex.: /usr/local/bin/uvx), atualize sua configuração para usar esse caminho (ex.: "command": "/usr/local/bin/uvx").

3. Como usar generate_video no modo assíncrono

Defina as regras de conclusão antes de começar: Alternativamente, essas regras podem ser configuradas nas configurações do seu IDE (ex.: Cursor):

Exemplos de Uso

⚠️ Aviso: O uso dessas ferramentas pode gerar custos.

1. transmitir um segmento do noticiário noturno

2. clonar uma voz

3. gerar um vídeo

4. gerar imagens