Flux ImageGen MCP Server

Un servidor MCP para generar imágenes usando la API de Pollinations AI.

Documentación

Servidor MCP de Flux ImageGen

Un servidor especializado del Protocolo de Contexto de Modelos (MCP) para generación y manipulación de imágenes, impulsado por Pollinations AI.

Desarrollador

Autor: Falah.G.Salieh
Derechos de autor: © 2025 Todos los derechos reservados

Descripción general

ImageGen MCP Server es una implementación de servidor optimizada que proporciona potentes capacidades de generación de imágenes a través del Protocolo de Contexto de Modelos (MCP). Este servidor se especializa en tres funcionalidades principales:

Generación de URL de imágenes
Generación directa de imágenes
Listado y gestión de modelos

Características

🖼️ Generación de imágenes: Crea imágenes impresionantes a partir de indicaciones de texto
🎨 Múltiples modelos: Compatibilidad con varios modelos de generación de imágenes
🔧 Configuración flexible: Fácil de configurar y personalizar
🚀 Alto rendimiento: Optimizado para tiempos de respuesta rápidos
🔄 Compatible con MCP: Totalmente conforme al Protocolo de Contexto de Modelos

Instalación

# Clone the repository
git clone https://github.com/yourusername/flux-imagegen-mcp-server.git

# Install dependencies
npm install

Configuración

Configuración de Claude Desktop

Para usar este servidor con Claude Desktop, actualice su archivo de configuración en: C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpollinations": {
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "PATH_TO_YOUR_SERVER\\server.js"
      ],
      "tools": [
        "generateImageUrl",
        "generateImage",
        "listImageModels"
      ]
    }
  }
}

Reemplace PATH_TO_YOUR_SERVER con la ruta real de su servidor.

Herramientas disponibles

1. Generar URL de imagen (`generateImageUrl`)

Genera una URL para una imagen basada en una indicación de texto.

{
  "prompt": "A beautiful sunset over mountains",
  "model": "flux",  // optional, defaults to 'flux'
  "width": 1024,    // optional
  "height": 1024,   // optional
  "enhance": true,  // optional
  "safe": false     // optional
}

2. Generar imagen (`generateImage`)

Genera y guarda una imagen directamente a partir de una indicación de texto.

{
  "prompt": "A serene lake reflecting mountains",
  "model": "flux",
  "width": 1024,
  "height": 1024,
  "enhance": true,
  "safe": false,
  "outputPath": "./output",
  "fileName": "mountain_lake",
  "format": "png"
}

3. Listar modelos de imágenes (`listImageModels`)

Devuelve una lista de los modelos de generación de imágenes disponibles.

// Example response:
{
  "models": [
    {
      "id": "flux",
      "name": "Flux",
      "description": "Default image generation model"
    },
    // ... other models
  ]
}

Ejecución del servidor

# Start the server
node server.js

Requisitos del entorno

Node.js >= 16.0.0
NPM >= 7.0.0
Compatible con Windows/Linux/MacOS

Desarrollo

Para contribuir o modificar el servidor:

Haga un fork del repositorio
Cree su rama de funcionalidad
Realice sus cambios
Envíe una solicitud de extracción

Manejo de errores

El servidor proporciona mensajes de error detallados para problemas comunes:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": { /* Additional error details */ }
  }
}

Ejemplos

Generación básica de imágenes

// Generate an image URL
const response = await generateImageUrl({
  prompt: "A futuristic city at night",
  model: "flux",
  width: 1024,
  height: 1024
});

// Generate and save an image
const image = await generateImage({
  prompt: "A peaceful garden with butterflies",
  outputPath: "./images",
  fileName: "garden_scene"
});

Ejemplo de descarga de imagen

// Download an image from URL
const downloadResult = await downloadImage({
  imageUrl: "https://example.com/image.jpg",
  fileName: "downloaded-image",
  format: "png"
});

Soporte

Para problemas y solicitudes de funcionalidades, cree un issue en el repositorio o contacte al desarrollador:

Correo electrónico: [Su correo de contacto]
GitHub: [Su perfil de GitHub]

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulte el archivo LICENSE para más detalles.