MiniMax MCP

Serveur officiel MiniMax Model Context Protocol (MCP) permettant l'interaction avec de puissantes API de synthèse vocale et de génération vidéo/image. Ce serveur permet aux clients MCP comme Claude Desktop, Cursor, Windsurf, OpenAI Agents et d'autres de générer de la parole, de cloner des voix, de générer des vidéos, de générer des images et plus encore.

💡 Recommandé : MiniMax CLI (mmx-cli) — notre outil en ligne de commande officiel avec les derniers modèles et des fonctionnalités supplémentaires incluant le texte, la vision et la recherche. Fonctionne comme une compétence d'agent IA pour Claude Code, Cursor, OpenClaw, etc.

Documentation

• 中文文档
• MiniMax-MCP-JS - Implémentation JavaScript officielle de MiniMax MCP

Démarrage rapide avec un client MCP

1. Obtenez votre clé API sur MiniMax.
2. Installez uv (gestionnaire de paquets Python), installez avec curl -LsSf https://astral.sh/uv/install.sh | sh ou consultez le uv dépôt pour d'autres méthodes d'installation.
3. Important : L'hôte API et la clé varient selon la région et doivent correspondre ; sinon, vous rencontrerez une erreur Invalid API key.

Région	Global	Chine continentale
MINIMAX_API_KEY	obtenez-la sur MiniMax Global	obtenez-la sur MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Allez dans Claude > Settings > Developer > Edit Config > claude_desktop_config.json pour inclure ce qui suit :

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

⚠️ Avertissement : La clé API doit correspondre à l'hôte. Si une erreur "API Error: invalid api key" se produit, veuillez vérifier votre hôte API :

• Hôte Global : https://api.minimax.io
• Hôte Chine continentale : https://api.minimaxi.com

Si vous utilisez Windows, vous devrez activer le "Mode développeur" dans Claude Desktop pour utiliser le serveur MCP. Cliquez sur "Aide" dans le menu hamburger en haut à gauche et sélectionnez "Activer le mode développeur".

Cursor

Allez dans Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server pour ajouter la configuration ci-dessus.

C'est tout. Votre client MCP peut désormais interagir avec MiniMax via ces outils :

Transport

Nous prenons en charge deux types de transport : stdio et sse.

stdio	SSE
Exécution locale	Peut être déployé localement ou dans le cloud
Communication via stdout	Communication via network
Entrée : Prend en charge le traitement de local files ou de ressources URL valides	Entrée : Lorsqu'il est déployé dans le cloud, il est recommandé d'utiliser URL pour l'entrée

Outils disponibles

outil	description
text_to_audio	Convertit du texte en audio avec une voix donnée
list_voices	Liste toutes les voix disponibles
voice_clone	Clone une voix à l'aide de fichiers audio fournis
generate_video	Génère une vidéo à partir d'une invite
text_to_image	Génère une image à partir d'une invite
query_video_generation	Interroge le résultat d'une tâche de génération vidéo
voice_design	Génère une voix à partir d'une invite en utilisant un texte d'aperçu

Notes de version

2 juillet 2025

🆕 Nouveautés

• Conception vocale : Nouvel outil voice_design - créez des voix personnalisées à partir d'invites descriptives avec audio d'aperçu
• Amélioration vidéo : Ajout du modèle MiniMax-Hailuo-02 avec qualité ultra-claire et contrôles de durée/résolution

📈 Outils améliorés

• voice_design - Générez des voix personnalisées à partir de descriptions textuelles
• generate_video - Prend désormais en charge MiniMax-Hailuo-02 avec des options de durée 6s/10s et de résolution 768P/1080P

FAQ

1. invalid api key

Assurez-vous que votre clé API et votre hôte API correspondent à la même région

Région	Global	Chine continentale
MINIMAX_API_KEY	obtenez-la sur MiniMax Global	obtenez-la sur MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Veuillez confirmer son chemin absolu en exécutant cette commande dans votre terminal :

which uvx

Une fois que vous avez obtenu le chemin absolu (par exemple, /usr/local/bin/uvx), mettez à jour votre configuration pour utiliser ce chemin (par exemple, "command": "/usr/local/bin/uvx").

3. Comment utiliser generate_video en mode asynchrone

Définissez les règles de complétion avant de commencer : Alternativement, ces règles peuvent être configurées dans les paramètres de votre IDE (par exemple, Cursor) :

Exemple d'utilisation

⚠️ Avertissement : L'utilisation de ces outils peut entraîner des coûts.

1. diffuser un segment du journal du soir

2. cloner une voix

3. générer une vidéo

4. générer des images