MiniMax MCP Server

Serveur officiel MiniMax Model Context Protocol (MCP) permettant d'interagir avec les 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, cloner des voix, générer des vidéos, des images et bien plus.

💡 Recommandé : MiniMax CLI (mmx-cli) — notre outil officiel en ligne de commande avec les derniers modèles et des fonctionnalités supplémentaires incluant le texte, la vision, la recherche et la reprise musicale. 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 auprès de MiniMax.
2. Installez uv (gestionnaire de paquets Python), installez avec curl -LsSf https://astral.sh/uv/install.sh | sh ou consultez le dépôt uv pour d'autres méthodes d'installation.
3. Important : L'hôte et la clé API varient selon la région et doivent correspondre ; sinon, vous rencontrerez une erreur Invalid API key.

Région	Global	Chine continentale
MINIMAX_API_KEY	à obtenir depuis MiniMax Global	à obtenir depuis 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 maintenant 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 : Lors d'un déploiement dans le cloud, il est recommandé d'utiliser URL pour l'entrée

Outils disponibles

outil	description
text_to_audio	Convertir du texte en audio avec une voix donnée
list_voices	Lister toutes les voix disponibles
voice_clone	Cloner une voix à l'aide de fichiers audio fournis
generate_video	Générer une vidéo à partir d'un prompt
text_to_image	Générer une image à partir d'un prompt
query_video_generation	Interroger le résultat d'une tâche de génération vidéo
music_generation	Générer une piste musicale à partir d'un prompt et de paroles
voice_design	Générer une voix à partir d'un prompt 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 de descriptions textuelles avec un aperçu audio
• Amélioration vidéo : Ajout du modèle MiniMax-Hailuo-02 avec une qualité ultra-claire et des contrôles de durée/résolution
• Génération musicale : Outil music_generation amélioré, propulsé par le modèle music-1.5

📈 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
• music_generation - Création musicale de haute qualité avec le modèle music-1.5

FAQ

1. invalid api key

Veuillez vous assurer que votre clé API et votre hôte API sont alignés régionalement

Région	Global	Chine continentale
MINIMAX_API_KEY	à obtenir depuis MiniMax Global	à obtenir depuis 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) :

Exemples 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