Image Generation MCP Server

Image Generation MCP Server

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

Instalación

Instalación mediante Smithery

Para instalar Image Generation MCP Server para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude

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

Puedes usar el paquete directamente desde npm sin instalarlo localmente:

# No installation needed - npx will handle it

Opción 2: Instalación local

Si prefieres 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

Edita tu 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 instalaste 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": []
    }
  }
}

Obtén tu token de API de Replicate

1. Regístrate/inicia sesión en https://replicate.com
2. Ve a https://replicate.com/account/api-tokens
3. Crea un nuevo token de API
4. Copia el token y reemplaza your-replicate-api-token en la configuración de MCP

Variables de entorno

• REPLICATE_API_TOKEN (obligatorio): Tu token de API de Replicate para la autenticación
• MODEL (opcional): El modelo de Replicate a utilizar 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

generate_image

Genera imágenes utilizando el modelo Flux a partir de 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 (valor predeterminado: "1:1")
• output_format (opcional): Formato de salida: "webp", "jpg" o "png" (valor predeterminado: "webp")
• num_outputs (opcional): Número de imágenes a generar (1-4, valor 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 de las imágenes generadas.

📜 Licencia

Este proyecto está bajo la Licencia MIT.