Servidor MCP de generación de imágenes

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

Instalación

Opción 1: Método NPX (no requiere configuración local)

Puede utilizar el paquete directamente desde npm sin instalarlo localmente:

# No installation needed - npx will handle it

Opción 2: Instalación local

Si prefiere una instalación local:

# Global installation
npm install -g @gongrzhe/image-gen-server

# Or local installation
npm install @gongrzhe/image-gen-server

Configuración

Configurar Claude Desktop

Edite su archivo de configuración de Claude Desktop:

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

Opción 1: Configuración NPX (recomendada)

Este método ejecuta el servidor directamente desde npm sin necesidad de archivos locales:

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["@gongrzhe/image-gen-server"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Opción 2: Configuración de instalación local

Si instaló el paquete localmente:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Obtenga su token de API de réplica

Regístrese/inicie sesión en https://replicate.com
Vaya a https://replicate.com/account/api-tokens
Crear un nuevo token de API
Copie el token y reemplace your-replicate-api-token en la configuración de MCP

Variables de entorno

REPLICATE_API_TOKEN (obligatorio): Su token de API de replicación para autenticación
MODEL (opcional): El modelo de réplica que se usará para la generación de imágenes. El valor predeterminado es "black-forest-labs/flux-schnell".

Parámetros de configuración

disabled : controla si el servidor está habilitado ( false ) o deshabilitado ( true )
autoApprove : Matriz de nombres de herramientas que se pueden ejecutar sin confirmación del usuario. Una matriz vacía significa que todas las llamadas a herramientas requieren confirmación.

Herramientas disponibles

generar_imagen

Genera imágenes utilizando el modelo Flux basándose en indicaciones de texto.

Parámetros

prompt (obligatorio): Descripción de texto de la imagen a generar
seed (opcional): semilla aleatoria para generación reproducible
aspect_ratio (opcional): Relación de aspecto de la imagen (predeterminado: "1:1")
output_format (opcional): Formato de salida: "webp", "jpg" o "png" (predeterminado: "webp")
num_outputs (opcional): Número de imágenes a generar (1-4, predeterminado: 1)

Ejemplo de uso

const result = await use_mcp_tool({
  server_name: "image-gen",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "16:9",
    output_format: "png",
    num_outputs: 1
  }
});

La herramienta devuelve una matriz de URL a las imágenes generadas.

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT.