Flujo de réplica MCP

Replicate Flux MCP es un servidor avanzado de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA generar imágenes y gráficos vectoriales de alta calidad. Utiliza el modelo Flux Schnell de Black Forest Labs para imágenes raster y el modelo SVG V3 de Recraft para gráficos vectoriales mediante la API Replicate.

📑 Índice de contenidos

Primeros pasos e integración
Características
Documentación
- Herramientas disponibles
- Recursos disponibles
Desarrollo
Detalles técnicos
Solución de problemas
Contribuyendo
Licencia
Recursos
Ejemplos

🚀 Primeros pasos e integración

Proceso de configuración

Obtener un token de API replicado
- Regístrate en Replicate
- Crea un token API en la configuración de tu cuenta
Elija su método de integración
- Siga una de las opciones de integración a continuación según su cliente MCP preferido
Pídale a su asistente de IA que genere una imagen
- Simplemente pregunte con naturalidad: "¿Puedes generar una imagen de un paisaje de montaña sereno al atardecer?"
- O sea más específico: "Por favor, cree una imagen que muestre una escena tranquila de montaña con un lago que refleje los colores del atardecer en primer plano".
Explorar funciones avanzadas
- Pruebe diferentes configuraciones de parámetros para obtener resultados personalizados
- Experimente con la generación de SVG usando generate_svg
- Utilice las funciones de generación de imágenes por lotes o de generación de variantes

Integración del cursor

Método 1: Usar mcp.json

Cree o edite el archivo .cursor/mcp.json en el directorio de su proyecto:

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "env REPLICATE_API_TOKEN=YOUR_TOKEN npx",
      "args": ["-y", "replicate-flux-mcp"]
    }
  }
}

Reemplace YOUR_TOKEN con su token de API de replicación real
Reinicie el cursor para aplicar los cambios

Método 2: Modo manual

Abra Cursor y vaya a Configuración
Vaya a la sección "MCP" o "Protocolo de contexto de modelo"
Haga clic en "Agregar servidor" o equivalente
Introduzca el siguiente comando en el campo correspondiente:

env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp

Reemplace YOUR_TOKEN con su token de API de replicación real
Guarde la configuración y reinicie Cursor si es necesario

Integración de escritorio de Claude

Cree o edite el archivo mcp.json en su directorio de configuración:

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": ["-y", "replicate-flux-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR TOKEN"
      }
    }
  }
}

Reemplace YOUR_TOKEN con su token de API de replicación real
Reinicie Claude Desktop para aplicar los cambios

Integración de herrería

Este servidor MCP está disponible como un servicio alojado en Smithery, lo que le permite usarlo sin configurar su propio servidor.

Visita Smithery y crea una cuenta si no tienes una
Navegue a la página del servidor MCP de Replicate Flux
Haga clic en "Agregar al espacio de trabajo" para agregar el servidor a su espacio de trabajo de Smithery
Configure su cliente MCP (Cursor, Claude Desktop, etc.) para utilizar la URL de su espacio de trabajo de Smithery

Para obtener más información sobre el uso de Smithery con sus clientes MCP, visita la documentación de Smithery .

Integración de Glama.ai

Este servidor MCP también está disponible como un servicio alojado en Glama.ai, lo que proporciona otra opción para usarlo sin configuración local.

Visita Glama.ai y crea una cuenta si no tienes una
Vaya a la página del servidor MCP de Replicate Flux
Haga clic en "Instalar servidor" para agregar el servidor a su espacio de trabajo
Configure su cliente MCP para usar su espacio de trabajo Glama.ai

Para obtener más información, visita la documentación de los servidores MCP de Glama.ai .

🌟 Características

🖼️ Generación de imágenes de alta calidad : cree imágenes impresionantes con Flux Schnell, un modelo de IA de última generación
🎨 Compatibilidad con gráficos vectoriales : genere gráficos vectoriales SVG profesionales con el modelo SVG de Recraft V3
🤖 Integración del asistente de IA : habilite sin problemas a asistentes de IA como Claude para generar contenido visual
🎛️ Personalización avanzada : ajuste la generación con controles de relación de aspecto, calidad, resolución y más
🔌 Compatibilidad universal con MCP : funciona con todos los clientes MCP, incluidos Cursor, Claude Desktop, Cline y Zed
🔒 Procesamiento local seguro : todas las solicitudes se procesan localmente para mayor privacidad y seguridad.
🔍 Gestión integral del historial : realice un seguimiento, visualice y recupere su historial generacional completo
📊 Procesamiento por lotes : genere múltiples imágenes a partir de diferentes indicaciones en una sola solicitud
🔄 Exploración de variantes : crea y compara múltiples interpretaciones del mismo concepto
✏️ Ingeniería de indicaciones : ajuste las variaciones de la imagen con modificaciones de indicaciones especializadas

📚 Documentación

Herramientas disponibles

`generate_image`

Genera una imagen basada en un mensaje de texto utilizando el modelo Flux Schnell.

{
  prompt: string;                // Required: Text description of the image to generate
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  num_outputs?: number;          // Optional: Number of images to generate (1-4) (default: 1)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_multiple_images`

Genera múltiples imágenes basadas en una serie de indicaciones utilizando el modelo Flux Schnell.

{
  prompts: string[];             // Required: Array of text descriptions for images to generate (1-10 prompts)
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_image_variants`

Genera múltiples variantes de la misma imagen a partir de un único mensaje.

{
  prompt: string;                // Required: Text description for the image to generate variants of
  num_variants: number;          // Required: Number of image variants to generate (2-10, default: 4)
  prompt_variations?: string[];  // Optional: List of prompt modifiers to apply to variants (e.g., ["in watercolor style", "in oil painting style"])
  variation_mode?: "append" | "replace"; // Optional: How to apply variations - 'append' adds to base prompt, 'replace' uses variations directly (default: "append")
  seed?: number;                 // Optional: Base random seed. Each variant will use seed+variant_index
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_svg`

Genera una imagen vectorial SVG basada en una solicitud de texto utilizando el modelo SVG de Recraft V3.

{
  prompt: string;                // Required: Text description of the SVG to generate
  size?: string;                 // Optional: Size of the generated SVG (default: "1024x1024")
  style?: string;                // Optional: Style of the generated image (default: "any")
                                // Options: "any", "engraving", "line_art", "line_circuit", "linocut"
}

`prediction_list`

Recupera una lista de tus predicciones recientes de Replicate.

{
  limit?: number;  // Optional: Maximum number of predictions to return (1-100) (default: 50)
}

`get_prediction`

Obtiene información detallada sobre una predicción específica.

{
  predictionId: string;  // Required: ID of the prediction to retrieve
}

Recursos disponibles

`imagelist`

Explore su historial de imágenes generadas creadas con el modelo Flux Schnell.

`svglist`

Explore su historial de imágenes SVG generadas con el modelo SVG de Recraft V3.

`predictionlist`

Explora todo tu historial de predicciones de Replicate.

💻 Desarrollo

Clonar el repositorio:

git clone https://github.com/yourusername/replicate-flux-mcp.git
cd replicate-flux-mcp

Instalar dependencias:

npm install

Iniciar modo de desarrollo:

npm run dev

Construir el proyecto:

npm run build

Conectarse al cliente:

{
  "mcpServers": {
    "image-generation-mcp": {
      "command": "npx",
      "args": [
        "/Users/{USERNAME}/{PATH_TO}/replicate-flux-mcp/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR REPLICATE API TOKEN"
      }
    }
  }
}

⚙️ Detalles técnicos

Pila

SDK de protocolo de contexto de modelo : funcionalidad principal de MCP para la gestión de herramientas y recursos
API de replicación : proporciona acceso a modelos de generación de imágenes de IA de última generación
TypeScript : garantiza la seguridad de los tipos y aprovecha las funciones modernas de JavaScript.
Zod : implementa la validación de tipos en tiempo de ejecución para interacciones API robustas

Configuración

El servidor se puede configurar modificando el objeto CONFIG en src/config/index.ts :

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2",
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // ms
};

🔍 Solución de problemas

Problemas comunes

Error de autenticación

Asegúrese de que su REPLICATE_API_TOKEN esté configurado correctamente en el entorno
Verifique que su token sea válido probándolo directamente con la API de Replicación

Filtro de seguridad activado

El modelo tiene un filtro de seguridad incorporado que puede bloquear ciertas indicaciones.
Intente modificar su mensaje para evitar contenido potencialmente problemático

Error de tiempo de espera

Para imágenes más grandes o servidores ocupados, es posible que deba aumentar pollingAttempts o pollingInterval en la configuración.
La configuración predeterminada debería funcionar para la mayoría de los casos de uso.

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos para contribuir:

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Para solicitudes de funciones o informes de errores, crea una incidencia en GitHub. Si te gusta este proyecto, ¡considera añadir el repositorio a tus favoritos!

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🔗 Recursos

🎨 Ejemplos

Múltiples indicaciones	Variantes de indicaciones

A continuación se muestran algunos ejemplos de cómo utilizar las herramientas:

Generación de imágenes por lotes con `generate_multiple_images`

Crea varias imágenes distintas a la vez con diferentes indicaciones:

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

Variantes de imagen con `generate_image_variants`

Crea diferentes interpretaciones del mismo concepto usando semillas:

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

O explore variaciones de estilo con modificadores de indicaciones:

{
  "prompt": "A character portrait",
  "prompt_variations": [
    "in anime style", 
    "in watercolor style", 
    "in oil painting style", 
    "as a 3D render"
  ]
}

Hecho con ❤️ por Yaroslav Boiko

Integrations