Flux Schnell MCP Server

Servidor MCP de Flux Schnell

Un servidor basado en MCP (Protocolo de Contexto de Modelo) para generar imágenes llamando al modelo Flux Schnell a través de la API de Replicate.

Características

• Proporciona la herramienta generate_image para generar imágenes
• Soporta indicaciones de texto personalizadas
• Maneja automáticamente la comunicación con la API de Replicate
• Manejo completo de errores y respuestas

Requisitos previos

1. Node.js (v14 o superior)
2. Token de API de Replicate
3. Entorno compatible con MCP (como Claude Desktop)

Cómo obtener un Token de API de Replicate

1. Visite el sitio web de Replicate y regístrese para obtener una cuenta
2. Después de iniciar sesión, visite la página de Tokens de API
3. Haga clic en "Create API token" para crear un nuevo token
4. Copie el token generado (formato como: r8_xxxxxx)

Instalación

1. Clone el proyecto e instale las dependencias:

git clone [repository-url]
cd flux-schnell-mcp
npm install

2. Compile el servidor:

npm run build

Configuración

Configuración de Claude Desktop

1. Abra el archivo de configuración:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Agregue la configuración del servidor:

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

Configuración de VSCode Roo

1. Abra el archivo de configuración:

   • Linux: ~/.vscode-remote/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • MacOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

2. Agregue la misma configuración del servidor que se indicó anteriormente.

Uso

El servidor proporciona una herramienta llamada generate_image, que se puede invocar a través de MCP:

<use_mcp_tool>
<server_name>flux-schnell</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "a beautiful sunset over the ocean, digital art style"
}
</arguments>
</use_mcp_tool>

Descripción de parámetros

• prompt: Descripción de texto utilizada para generar la imagen (obligatorio)
  • Se recomienda usar descripciones detalladas para obtener mejores resultados de generación
  • Puede incluir información sobre estilo, escena, detalles, etc.

Formato de respuesta

El servidor devolverá la respuesta completa de la API de Replicate, incluyendo la URL de la imagen generada y otros metadatos.

Depuración

Dado que el servidor MCP se comunica a través de stdio, la depuración puede ser difícil. Se recomienda usar MCP Inspector:

npm run inspector

Inspector proporcionará una URL que se puede visitar en el navegador para acceder a las herramientas de depuración.

Notas

1. Guarde su Token de API de Replicate de forma segura y no lo comparta con otros
2. Asegúrese de usar las rutas de archivo correctas en el archivo de configuración
3. La generación de imágenes puede tomar algún tiempo, por favor espere la respuesta con paciencia
4. Si encuentra errores, verifique que el Token de API sea correcto y que la conexión de red funcione correctamente