Image MCP Server

Un servidor MCP para generación de imágenes con IA utilizando las APIs de OpenAI y Replicate.

GitHubPrueba este MCPPatrocinado

Documentación

Image MCP Server

Un servidor MCP (Model Context Protocol) que proporciona capacidades de generación de imágenes con IA utilizando el módulo npm ai-image, que envuelve las APIs de inferencia de imágenes de OpenAI y Replicate.

Características

  • generate_ai_image: Genera imágenes con IA con prompts, tamaños, modelos y estilos personalizables
  • square_image: Genera imágenes cuadradas (1024x1024) - comando de acceso rápido
  • landscape_image: Genera imágenes horizontales (1536x1024) - comando de acceso rápido
  • portrait_image: Genera imágenes verticales (1024x1536) - comando de acceso rápido
  • Construido sobre el módulo ai-image para una integración perfecta con las APIs de OpenAI y Replicate
  • Configuración e instalación sencillas

Instalación

npm install -g image-mcp

Configuración

Configuración de Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "image-mcp": {
      "command": "npx",
      "args": ["image-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MCP_TIMEOUT": "1200000"
      },
      "resetTimeoutOnProgress": true
    }
  }
}

Variables de entorno

El servidor requiere claves de API para los servicios subyacentes de generación de imágenes:

  • OPENAI_API_KEY: Tu clave de API de OpenAI para modelos basados en GPT (no daremos soporte a los modelos Dall-e, ya que probablemente se eliminarán pronto)
  • REPLICATE_API_TOKEN: Tu token de API de Replicate para otros modelos de IA

Uso

Una vez configurado, puedes usar las funciones de generación de imágenes a través de Claude:

generate_ai_image

Genera imágenes con IA con varios parámetros:

  • prompt (obligatorio): Descripción textual de la imagen a generar
  • size (opcional): Dimensiones de la imagen en formato ANCHOxALTO (por defecto: "1024x1024")
  • model (opcional): Modelo de IA específico a utilizar
  • output (opcional): Ruta personalizada del archivo de salida

Comandos de acceso rápido

Para mayor comodidad, usa estos comandos con tamaños predefinidos:

  • square_image: Genera imágenes cuadradas de 1024x1024
  • landscape_image: Genera imágenes horizontales de 1536x1024
  • portrait_image: Genera imágenes verticales de 1024x1536

Todos los comandos de acceso rápido aceptan los mismos parámetros que generate_ai_image excepto size (que está predefinido).

Ejemplos de prompts:

  • "Un gato rojo al estilo Picasso"
  • "Una puesta de sol sobre montañas, fotorrealista"
  • "Patrones geométricos abstractos en azul y dorado"

Desarrollo

# Clone the repository
git clone https://github.com/iplanwebsites/image-mcp.git
cd image-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Start the server
npm start

Requisitos

  • Node.js >= 18.0.0
  • Claves de API válidas para OpenAI y/o Replicate

Tareas pendientes

Urgentes

  • Corregir problema del módulo npm: Solo funciona localmente...

Mejoras

  • Mejores guías: Añadir guías de configuración más detalladas con pasos de solución de problemas, un botón de Añadir a cursor, etc.

  • Usar la librería ai-image directamente: Reemplazar las llamadas CLI de subprocesos con importaciones directas de la librería

  • Devolver rutas de archivos: Devolver las rutas de los archivos de imagen creados en la respuesta

  • Soporte de inferencia local: Añadir soporte para modelos locales como Flux

  • Optimización de imágenes: Añadir opciones ligeras de redimensionado y optimización de imágenes

  • Herramienta de subtitulado de imágenes: Añadir un modelo de subtitulado para casos de uso básicos (útil para modelos sin visión)

Licencia

MIT