Flux Image MCP Server

Genera imágenes usando el modelo Flux Schnell de Replicate.

Documentación

Servidor MCP de Flux Image

Este servidor MCP proporciona capacidades de generación de imágenes utilizando el modelo Flux Schnell en Replicate.

Instalación

Instale el MCP SDK globalmente:

npm install -g @modelcontextprotocol/sdk@latest

Clone este repositorio en su directorio de servidores MCP:

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

Compile el servidor:

npm run build

Agregue la configuración del servidor a su archivo de configuración MCP (ya sea global o del espacio de trabajo):

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Configuración

El servidor requiere la siguiente variable de entorno:

REPLICATE_API_TOKEN: Su token de API de Replicate. Puede obtenerlo desde su configuración de cuenta de Replicate.

Uso

Una vez instalado y configurado, el servidor proporciona la siguiente herramienta:

generate_image

Genera una imagen utilizando el modelo Flux Schnell basado en un prompt de texto.

Parámetros:

prompt (cadena, obligatorio): Descripción de texto de la imagen deseada

Ejemplo de uso:

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

La herramienta devolverá una respuesta JSON que contiene:

status: El estado de la solicitud de generación
output: La URL de la imagen generada (si fue exitosa)
error: Cualquier mensaje de error (si falló)

Desarrollo

Para realizar cambios en el servidor:

Modifique el código fuente en src/index.ts
Recompile el servidor: npm run build
Reinicie el servidor MCP para que los cambios surtan efecto

Manejo de Errores

El servidor incluye un manejo integral de errores para:

Token de API faltante
Parámetros no válidos
Fallos en solicitudes de API
Problemas de red

Seguridad

Nunca confirme su token de API de Replicate en el control de versiones
Siempre proporcione el token a través de variables de entorno
El servidor valida todos los parámetros de entrada antes de realizar solicitudes de API