MiniMax MCP
officielInteragir avec les puissantes API de génération Text-to-Speech, d'images et de vidéos de MiniMax.
Que pouvez-vous faire avec MiniMax MCP ?
- Synthèse vocale — Demandez à l’assistant de convertir du texte écrit en audio avec une voix spécifiée.
- Clonage vocal — Clonez une voix à partir des fichiers audio que vous fournissez, puis réutilisez-la pour générer de la parole.
- Conception vocale — Générez une voix personnalisée à partir d’une description, avec un aperçu audio.
- Génération et retouche d’images — Créez des images à partir de prompts dans des zones de 1K/2K/4K, ou retouchez une image à l’aide d’un prompt et de jusqu’à 16 images de référence.
- Génération vidéo — Générez une vidéo à partir d’un prompt, avec des options de durée et de résolution, puis consultez le résultat de la tâche.
Documentation

Serveur officiel MiniMax Model Context Protocol (MCP) permettant d’interagir avec de puissantes API de synthèse vocale et de génération de vidéos/images. Ce serveur permet aux clients MCP tels que 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 et des images, et bien plus encore.
💡 Recommandé : MiniMax CLI (mmx-cli) — notre outil officiel en ligne de commande, qui propose les derniers modèles et des fonctionnalités supplémentaires, notamment le texte, la vision et la recherche. Fonctionne comme compétence d’agent IA pour Claude Code, Cursor, OpenClaw, etc.
Documentation
- Documentation en chinois
- MiniMax-MCP-JS - Implémentation officielle de MiniMax MCP en JavaScript
Démarrage rapide avec un client MCP
- Obtenez votre clé API auprès de MiniMax.
- Installez
uv(gestionnaire de paquets Python), puis installez aveccurl -LsSf https://astral.sh/uv/install.sh | shou consultez le dépôtuvpour découvrir d’autres méthodes d’installation. - 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 auprès de MiniMax Global | à obtenir auprès de MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Claude Desktop
Accédez à 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 l’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
Sous Windows, vous devez activer le « Mode développeur » dans Claude Desktop pour utiliser le serveur MCP. Cliquez sur « Aide » dans le menu hamburger en haut à gauche, puis sélectionnez « Activer le mode développeur ».
Cursor
Accédez à Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server pour ajouter la configuration ci-dessus.
Voilà, votre client MCP peut maintenant interagir avec MiniMax à l’aide de 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 ressources local files ou URL valides | Entrée : en cas de 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 | Répertorier toutes les voix disponibles |
voice_clone | Cloner une voix à partir des fichiers audio fournis |
generate_video | Générer une vidéo à partir d’une invite |
text_to_image | Générer une image à partir d’une invite. Utilise MiniMax-H3-Image par défaut (prend en charge area 1K/2K/4K et size) ; image-01 reste disponible via model |
image_edit | Modifier une image avec MiniMax-H3-Image à l’aide d’une invite et de 1 à 16 images de référence |
query_video_generation | Interroger le résultat d’une tâche de génération vidéo |
voice_design | Générer une voix à partir d’une invite à l’aide d’un texte d’aperçu |
Notes de version
10 novembre 2026
🆕 Nouveautés
- Modification d’image : nouvel outil
image_edit— modifier des images avec MiniMax-H3-Image à l’aide d’une invite et de 1 à 16 images de référence (URL, URI de données,mm_file://ou chemin local) - Génération d’images H3 :
text_to_imageutilise désormais MiniMax-H3-Image par défaut et prend en chargearea(1K/2K/4K) etsize;image-01reste disponible via le paramètremodel
📈 Outils améliorés
text_to_image- Utilise MiniMax-H3-Image par défaut (/v1/images/generations) ; transmettezmodel="image-01"pour utiliser le modèle précédent
2 juillet 2025
🆕 Nouveautés
- Conception de voix : nouvel outil
voice_design- créer des voix personnalisées à partir d’invites descriptives avec un aperçu audio - Amélioration vidéo : ajout du modèle
MiniMax-Hailuo-02avec une qualité ultra-nette et des commandes de durée/résolution
📈 Outils améliorés
voice_design- Générer des voix personnalisées à partir de descriptions textuellesgenerate_video- Prend désormais en charge MiniMax-Hailuo-02 avec des options de durée de 6 s/10 s et de résolution 768P/1080P
FAQ
1. Clé API invalide
Veuillez vérifier que votre clé API et votre hôte API correspondent à la même région.
| Région | Global | Chine continentale |
|---|---|---|
| MINIMAX_API_KEY | à obtenir auprès de MiniMax Global | à obtenir auprès de 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 le chemin absolu obtenu (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 d’achèvement avant de commencer :
Vous pouvez également configurer ces règles dans les paramètres de votre IDE (par exemple, Cursor) :

Exemples d’utilisation
⚠️ Avertissement : l’utilisation de ces outils peut entraîner des frais.
1. Diffuser un extrait du journal télévisé du soir
2. Cloner une voix
3. Générer une vidéo
4. Générer des images
