MiniMax MCP

Servidor oficial MiniMax Model Context Protocol (MCP) que permite interação com poderosas APIs de Texto para Fala e geração de vídeo/imagem. Este servidor permite que clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents e outros gerem fala, clonem vozes, gerem vídeo, gerem imagens 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 e busca. 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 consulte o uv repositório para métodos adicionais de instalação.
3. Importante: O host e a chave da API variam por região e devem corresponder; caso contrário, você encontrará um erro de 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 da 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.

É isso. Seu cliente MCP agora pode interagir com o MiniMax por meio destas ferramentas:

Transporte

Suportamos dois tipos de transporte: stdio e sse.

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

Ferramentas Disponíveis

ferramenta	descrição
text_to_audio	Converte texto em áudio com uma voz fornecida
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
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

📈 Ferramentas Aprimoradas

• voice_design - Gere vozes personalizadas a partir de descrições de texto
• generate_video - Agora suporta MiniMax-Hailuo-02 com duração de 6s/10s e opções de resolução 768P/1080P

FAQ

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 o caminho absoluto executando este comando no seu terminal:

which uvx

Depois de obter o caminho absoluto (por exemplo, /usr/local/bin/uvx), atualize sua configuração para usar esse caminho (por exemplo, "command": "/usr/local/bin/uvx").

3. Como usar generate_video em modo assíncrono

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

Exemplo de uso

⚠️ Aviso: Usar estas ferramentas pode gerar custos.

1. transmitir um segmento do noticiário noturno

2. clonar uma voz

3. gerar um vídeo

4. gerar imagens