servidor MCP fal-ai/minimax/image-01

Un servidor de protocolo de contexto de modelo (MCP) que proporciona acceso al modelo de generación de imágenes fal-ai/minimax/image-01. Este servidor permite generar imágenes de alta calidad con capacidades superiores utilizando tecnología avanzada de IA a través de la plataforma fal.ai.

Características

• Generación de imágenes de alta calidad: Genera imágenes asombrosas utilizando el modelo fal-ai/minimax/image-01
• Capacidades superiores deIA: Generación avanzada de texto a imagen con una calidad excelente
• Múltiples métodos de generación: Compatibilidad con generación sincrónica y basada en colas
• Relaciones de aspecto flexibles: Admite varias relaciones de aspecto, desde cuadradas hasta panorámicas
• Optimización deavisos: Mejora opcional de los avisos para obtener mejores resultados
• Descarga local de imágenes: Descarga automática de las imágenes generadas al almacenamiento local
• Gestión de colas: Envíe solicitudes de larga duración y compruebe su estado
• Soporte Webhook: Notificaciones webhook opcionales para solicitudes completadas

Instalación

1. Clone este repositorio:

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

2. Instalar dependencias:

npm install

3. Construye el proyecto:

npm run build

Configuración

Variables de entorno

Establece tu clave de la API de fal.ai como variable de entorno:

export FAL_KEY="tu_clave_api_fal_aquí"

Puedes obtener tu clave API en fal.ai.

Configuración del cliente MCP

Añade este servidor a la configuración de tu cliente MCP. Por ejemplo, en el archivo de configuración 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 el paquete está publicado en npm, puede utilizar:

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

Alternativamente, si has clonado el repositorio localmente:

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

Herramientas disponibles

1. minimax_generate

Genera imágenes utilizando el método síncrono estándar.

Parámetros:

• prompt (obligatorio): Texto descriptivo de la imagen a generar (máximo 1500 caracteres)
• aspect_ratio (opcional): Relación de aspecto de la imagen generada (por defecto: "1:1")
• num_images (opcional): Número de imágenes a generar (1-9, por defecto: 1)
• prompt_optimizer (opcional): Habilitar la optimización del prompt para obtener mejores resultados
• sync_mode (opcional): Esperar a la finalización (por defecto: true)

Ejemplo:

{ "prompt": "Un paisaje urbano futurista con coches voladores y luces de neón", "aspect_ratio": "16:9", "num_images": 2, "prompt_optimizer": true }

2. minimax_generate_queue

Envía una solicitud de generación de imágenes de larga duración a la cola.

Parámetros: Igual que minimax_generate más:

• webhook_url (opcional): URL para notificaciones webhook

Devuelve: Un ID de solicitud para el seguimiento del trabajo

3. minimax_queue_status

Comprueba el estado de una petición en cola.

Parámetros:

• request_id (obligatorio): El ID de solicitud del envío de la cola
• logs (opcional): Incluir registros en la respuesta (por defecto: true)

4. minimax_queue_result

Obtiene el resultado de una solicitud en cola completada.

Parámetros:

• request_id (obligatorio): El ID de la petición desde el envío de la cola

Relaciones de aspecto

El modelo MiniMax admite las siguientes relaciones de aspecto:

• 1:1: Formato cuadrado (por defecto)
• 16:9: Pantalla panorámica horizontal
• 4:3: Horizontal estándar
• 3:2: Horizontal clásico
• 2:3: Retrato fotográfico clásico
• 3:4: Retrato estándar
• 9:16: Formato vertical/móvil
• 21:9: Panorámica ultraancha

Ejemplo:

{ "aspect_ratio": "16:9" }

Optimización de avisos

Habilite la optimización de avisos para mejorar sus avisos de texto y obtener mejores resultados:

{ "prompt_optimizer": true }

Cuando se activa, la IA mejorará automáticamente su aviso para generar imágenes de mayor calidad.

Salida

Las imágenes generadas se descargan automáticamente en un directorio local images/ con nombres de archivo descriptivos. La respuesta incluye

• Rutas de archivos locales
• URL originales
• Dimensiones de la imagen (si están disponibles)
• Tipos de contenido
• Tamaño de los archivos (si está disponible)
• Parámetros de generación utilizados
• ID de solicitud para el seguimiento
• Valores semilla para la reproducibilidad

Tratamiento de errores

El servidor proporciona mensajes de error detallados para:

• Falta de claves API
• Parámetros no válidos
• Problemas de red
• Límites de velocidad de la API
• Fallos de generación
• Infracciones de la longitud de la solicitud (máx. 1500 caracteres)

Desarrollo

Ejecución en modo de desarrollo

npm run dev

Probando el servidor

npm test

Obteniendo la ruta de instalación

npm run get-path

Referencia API

Este servidor implementa la API fal-ai/minimax/image-01. Para obtener documentación detallada sobre la API, visita

• documentación de fal.ai
• biblioteca de clientes de fal.ai

Ejemplos

Generación básica de texto a imagen

{ "prompt": "Un majestuoso dragón surcando las nubes" }

Imagen de paisaje con optimización

{ "prompt": "Un sereno paisaje de montaña al atardecer", "aspect_ratio": "16:9", "prompt_optimizer": true }

Generación de múltiples imágenes

{ "prompt": "Un lindo gato de dibujos animados en diferentes poses", "aspect_ratio": "1:1", "num_images": 4 }

Formato de retrato con pregunta detallada

{ "prompt": "Un retrato profesional de una mujer de negocios segura de sí misma en un entorno de oficina moderno, iluminación natural, alta resolución", "aspect_ratio": "2:3", "prompt_optimizer": true }

Generación basada en colas con Webhook

{ "prompt": "Una visualización arquitectónica detallada de una ciudad inteligente futurista con tecnología sostenible", "aspect_ratio" "21:9", "webhook_url": "https://your-server.com/webhook" }

Licencia

Licencia MIT - véase el archivo LICENSE para más detalles.

Contribución a

1. Fork el repositorio
2. Crear una rama
3. Haga sus cambios
4. Añada pruebas si es necesario
5. Envíe un pull request

Soporte

Para cuestiones y preguntas:

• Abrir una incidencia en GitHub
• Consulta la documentación de fal.ai

Registro de cambios

v1.0.0

• Versión inicial compatible con la API fal-ai/minimax/image-01
• Generación de texto a imagen con capacidades superiores de IA
• Compatibilidad con múltiples relaciones de aspecto (de 1:1 a 21:9)
• Optimización de avisos para mejorar los resultados
• Gestión de colas mediante webhook
• Función de descarga local de imágenes
• Posibilidad de generar hasta 9 imágenes por solicitud
• Gestión exhaustiva de errores