serveur MCP fal-ai/minimax/image-01

Un serveur MCP (Model Context Protocol) qui fournit un accès au modèle de génération d'images fal-ai/minimax/image-01. Ce serveur vous permet de générer des images de haute qualité avec des capacités supérieures en utilisant la technologie avancée de l'IA à travers la plateforme fal.ai.

Caractéristiques

• Génération d'images de haute qualité: Génère des images étonnantes en utilisant le modèle fal-ai/minimax/image-01
• Capacités supérieures d'IA: Génération avancée de texte à partir d'images d'excellente qualité
• Méthodes de génération multiples: Prise en charge de la génération synchrone et en file d'attente
• Ratios d'aspect flexibles: Prise en charge de divers rapports d'aspect, du carré au panoramique
• Optimisation des messages: Amélioration facultative des messages pour de meilleurs résultats
• Téléchargement d'images locales: Téléchargement automatique des images générées vers le stockage local
• Gestion de la file d'attente: Soumission des demandes en cours d'exécution et vérification de leur état
• Prise en charge des webhooks: Notifications webhook optionnelles pour les demandes terminées

Installation du référentiel

1. Clonez ce dépôt :

git clone https://github.com/PierrunoYT/fal-minimax-image-01-mcp-server.git cd fal-minimax-image-01-mcp-server

2. Installer les dépendances :

npm install

3. Construire le projet :

npm run build

Configuration de l'environnement

Variables d'environnement

Définissez votre clé d'API fal.ai comme variable d'environnement :

export FAL_KEY="votre_clé_d'API_fal_ici"

Vous pouvez obtenir votre clé API auprès de fal.ai.

Configuration du client MCP

Ajoutez ce serveur à la configuration de votre client MCP. Par exemple, dans le fichier de configuration de Claude Desktop :

{ "mcpServers" : { "fal-minimax-image-01" : { "command" : "npx", "args" : ["-y", "https://github.com/PierrunoYT/fal-minimax-image-01-mcp-server.git"], "env" : { "FAL_KEY" : "your_fal_api_key_here" } } } }

Si le paquet est publié sur npm, vous pouvez utiliser :

{ "mcpServers" : { "fal-minimax-image-01" : { "command" : "npx", "args" : ["fal-minimax-image-01-mcp-server"], "env" : { "FAL_KEY" : "your_fal_api_key_here" } } } }

Alternativement, si vous avez cloné le dépôt localement :

{ "mcpServers" : { "fal-minimax-image-01" : { "command" : "node", "args" : ["/path/to/fal-minimax-image-01-mcp-server/build/index.js"], "env" : { "FAL_KEY" : "your_fal_api_key_here" } } } }

Outils disponibles

1. minimax_generate

Génère des images en utilisant la méthode synchrone standard.

Paramètres :

• prompt (obligatoire) : Description textuelle de l'image à générer (max 1500 caractères)
• aspect_ratio (optionnel) : Rapport d'aspect de l'image générée (par défaut : "1:1")
• num_images (facultatif) : Nombre d'images à générer (1-9, par défaut : 1)
• prompt_optimizer (optionnel) : Active l'optimisation de l'invite pour de meilleurs résultats
• sync_mode (optionnel) : Attendre l'achèvement (par défaut : true)

Exemple :

{"prompt" : "Un paysage urbain futuriste avec des voitures volantes et des néons", "aspect_ratio" : "16:9", "num_images" : 2, "prompt_optimizer" : true }

2. minimax_generate_queue

Soumet une requête de génération d'image de longue durée à la file d'attente.

Paramètres : Identique à minimax_generate plus :

• webhook_url (optionnel) : URL pour les notifications du webhook

Retourne : Un identifiant de requête pour suivre le travail

3. minimax_queue_status

Vérifie le statut d'une requête en file d'attente.

Paramètres :

• request_id (obligatoire) : L'identifiant de la requête depuis la soumission de la file d'attente
• logs (optionnel) : Inclure les logs dans la réponse (par défaut : true)

4. minimax_queue_result

Obtenir le résultat d'une requête terminée dans la file d'attente.

Paramètres :

• request_id (obligatoire) : L'identifiant de la requête dans la file d'attente

Rapports d'aspect

Le modèle MiniMax prend en charge les rapports d'aspect suivants :

• 1:1: format carré (par défaut)
• 16:9: Écran large paysage
• 4:3: Paysage standard
• 3:2: Paysage photo classique
• 2:3: Portrait classique
• 3:4: Portrait standard
• 9:16: Format vertical/mobile
• 21:9: Panoramique ultra-large

Exemple :

{ "aspect_ratio" : "16:9" }

Optimisation des invites

Activez l'optimisation des invites pour améliorer vos invites textuelles et obtenir de meilleurs résultats :

{ "prompt_optimizer" : true }

Lorsque cette option est activée, l'IA améliore automatiquement votre message-guide pour générer des images de meilleure qualité.

Sortie

Les images générées sont automatiquement téléchargées dans un répertoire local images/ avec des noms de fichiers descriptifs. La réponse comprend

• Chemins d'accès aux fichiers locaux
• URL d'origine
• Dimensions de l'image (le cas échéant)
• Types de contenu
• Taille des fichiers (si disponible)
• Paramètres de génération utilisés
• ID de la demande pour le suivi
• Valeurs d'amorçage pour la reproductibilité

Gestion des erreurs

Le serveur fournit des messages d'erreur détaillés en cas de

• Clés API manquantes
• Paramètres non valides
• Problèmes de réseau
• Limites de débit de l'API
• Échecs de génération
• Violation de la longueur de l'invite (max. 1500 caractères)

Développement

Exécution en mode développement

npm run dev

Test du serveur

npm test

Obtenir le chemin d'installation

npm run get-path

Référence de l'API

Ce serveur implémente l'API fal-ai/minimax/image-01. Pour une documentation détaillée de l'API, visitez le site :

• fal.ai Documentation
• bibliothèque client fal.ai

Exemples d'application

Génération basique de texte à partir d'une image

{"prompt" : "Un dragon majestueux s'élevant à travers les nuages" }

Image de paysage avec optimisation

{ "prompt" : "Un paysage de montagne serein au coucher du soleil", "aspect_ratio" : "16:9", "prompt_optimizer" : true }

Génération d'images multiples

{ "prompt" : "Un chat mignon de dessin animé dans différentes poses", "aspect_ratio" : "1:1", "num_images" : 4 }

Format portrait avec invite détaillée

{ "prompt" : "Une photo professionnelle d'une femme d'affaires confiante dans un bureau moderne, éclairage naturel, haute résolution", "aspect_ratio" : "2:3", "prompt_optimizer" : true }

Génération basée sur une file d'attente avec Webhook

{ "prompt" : "Une visualisation architecturale détaillée d'une ville intelligente futuriste avec une technologie durable", "aspect_ratio" : "21:9", "webhook_url" : "https://your-server.com/webhook" }

Licence

Licence MIT - voir le fichier LICENSE pour plus de détails.

Contribuer

1. Créer un dépôt (Fork)
2. Créer une branche de fonctionnalité
3. Effectuez vos modifications
4. Ajoutez des tests si nécessaire
5. Soumettre une demande d'extraction

Support

Pour les problèmes et les questions :

• Ouvrir un problème sur GitHub
• Consulter la documentation de fal.ai

Changelog

v1.0.0

• Version initiale avec le support de l'API fal-ai/minimax/image-01
• Génération texte-image avec des capacités d'IA supérieures
• Prise en charge de plusieurs rapports d'aspect (1:1 à 21:9)
• Optimisation des messages pour de meilleurs résultats
• Gestion des files d'attente avec prise en charge des webhooks
• Fonctionnalité de téléchargement d'images locales
• Possibilité de générer jusqu'à 9 images par requête
• Gestion complète des erreurs