/ Directorio / Playground / MCP Image
← Todos los servidores ↗ GitHub
● Comunidad shinpr 🔑 Requiere tu clave

MCP Image

por shinpr · shinpr/mcp-image

Genere y edite imágenes a través de Gemini (Nano Banana 2/Pro): optimización automática de mensajes, salida 4K, edición de lenguaje natural y coherencia de caracteres.

mcp-image envuelve los modelos de imágenes Gemini de Google (Nano Banana 2 / Nano Banana Pro) detrás de una única herramienta "generate_image". Dé un mensaje sencillo; el servidor lo enriquece con el marco Asunto-Contexto-Estilo antes de llamar al modelo, elige un nivel de calidad (rápido/equilibrado/calidad), admite la edición de imágenes mediante lenguaje natural y mantiene la coherencia de los caracteres entre generaciones. Salida de hasta 4K, relaciones de aspecto de 1:1 a 21:9. Requiere una clave API Gemini gratuita.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

mcp-image.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-image",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mcp-image -- npx -y mcp-image

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MCP Image

Generar y luego iterar una imagen principal para una página de destino

👤 Diseñadores, fundadores, especialistas en marketing. ⏱ ~15 min beginner

Cuándo usarlo: Quieres una imagen de héroe nueva y no quieres hacer malabarismos con 5 pestañas.

Requisitos previos
  • Clave API de Géminis — https://aistudio.google.com/apikey
  • Directorio de salida — mkdir -p ~/images/mcp
Flujo
  1. Generar v1
    Genere una imagen destacada: espacio de trabajo mínimo, luz cálida de hora dorada, 16:9, nivel de calidad, 2048 px.✓ Copiado
    → Imagen guardada en IMAGE_OUTPUT_DIR con mensaje enriquecido repetido
  2. Editar en el lugar
    Edítelo: agregue una delgada línea de árboles en el horizonte, conserve todo lo demás.✓ Copiado
    → Variante guardada; composición conservada
  3. Prueba una variante
    La misma escena pero en tonos más fríos, mantén el sujeto idéntico.✓ Copiado
    → La coherencia del carácter se mantiene; cambio de color

Resultado: Una imagen destacada que se puede enviar en minutos, no un viaje de ida y vuelta con asiento pagado a través de Midjourney.

Errores comunes
  • Solicitar demasiado al optimizador — Deje que el potenciador Asunto-Contexto-Estilo haga su trabajo; deja de anular con 5 líneas de adjetivos
Combinar con: filesystem

Producir un conjunto de ilustraciones coherentes con la marca.

👤 Fundadores y diseñadores solitarios sin una biblioteca de activos de marca ⏱ ~45 min intermediate

Cuándo usarlo: Necesita de 6 a 12 ilustraciones que parezcan estar juntas.

Flujo
  1. Definir la hoja de estilo
    Genera una referencia de estilo: ilustración plana, paleta de colores pastel suaves, viñeta de 2 caracteres.✓ Copiado
    → La imagen de la semilla captura el estilo.
  2. Crear variaciones
    Usando ese estilo, crea 6 ilustraciones para nuestras secciones: incorporación, facturación, equipo, integraciones, seguridad, análisis.✓ Copiado
    → 6 imágenes con estilo + personajes consistentes

Resultado: Un conjunto de ilustraciones coherente sin contratar a un ilustrador por un día.

Errores comunes
  • Deriva entre imágenes — Siempre haga referencia a la imagen de la semilla y use "mantener el estilo de la semilla"

Edite fotografías de productos con lenguaje natural

👤 Operadores de comercio electrónico, pequeñas marcas. ⏱ ~20 min beginner

Cuándo usarlo: Tienes una foto de producto sin editar y quieres el tratamiento de héroe sin Photoshop.

Flujo
  1. Subir/referenciar la foto
    Utilice product.jpg como base. Elimina el fondo desordenado; mantener la sombra; iluminación de estudio.✓ Copiado
    → Imagen de producto limpio con sombra natural.
  2. Agregar contexto
    El mismo producto sobre una cálida superficie de mármol, de arriba hacia abajo.✓ Copiado
    → Producto consistente con el nuevo entorno.

Resultado: Imágenes listas para catálogo en minutos.

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mcp-image + filesystem

Generar, listar, etiquetar y organizar una biblioteca de imágenes

Genere el conjunto de hoy en ~/images/mcp/2026-04-21/; luego enumere y cambie el nombre mediante texto alternativo.✓ Copiado
mcp-image + magic-ui-mcp

Suelta imágenes de héroes generadas en un aterrizaje de Magic UI

Genere una imagen de héroe y luego conéctela al componente de héroe de Magic UI.✓ Copiado
mcp-image + comfyui-mcp-server

Utilice mcp-image para generaciones únicas; ComfyUI para tuberías

Variantes rápidas a través de mcp-image; flujo de trabajo de producción a través de ComfyUI.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
generate_image prompt: str, tier?: fast|balanced|quality, aspect?: '1:1'|'16:9'|..., base_image?: path, size?: '1K'|'2K'|'4K' Genere una imagen nueva o edite una existente con lenguaje natural 1 Gemini image call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Obligado a la cuota de generación de imágenes de su plan API Gemini
Tokens por llamada
Insignificante para texto; los bytes de imagen dominan
Monetario
Pago por imagen a través de la API Gemini; nivel gratuito disponible para desarrollo
Consejo
Utilice tier=fast para la iteración y tier=quality solo para el guardián final.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: GEMINI_API_KEY solo en env: nunca confirmar. Girar desde Google AI Studio si se filtra.
Salida de datos: Las indicaciones y las imágenes base opcionales van a la API Gemini de Google. Los bytes generados regresan y se guardan localmente.

Resolución de problemas

Errores comunes y soluciones

401 / Clave API no válida

Confirme que GEMINI_API_KEY es la clave API sin formato de AI Studio (no el token de OAuth) y que tiene habilitada la generación de imágenes.

Verificar: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY
Salidas guardadas pero vacías

Es posible que IMAGE_OUTPUT_DIR no se pueda escribir o que falte. Créelo y vuelva a intentarlo.

Verificar: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe
El carácter se desplaza entre generaciones.

Pase siempre la misma base_image e incluya "mantener el tema idéntico" en el mensaje.

Verificar: Diff two generations visually

Alternativas

MCP Image vs otros

AlternativaCuándo usarlaContrapartida
everartTienes modelos Everart entrenados con estilo.Diferentes proveedores, diferentes estilos de cobertura
comfyui-mcp-serverNecesita flujos de trabajo SD/FLUX personalizados y control total de la canalizaciónConfiguración mucho más pesada
higgsfield-ai-prompt-skillQuiere ayuda de ingeniería inmediata para otro proveedorSólo indicaciones, sin inferencias

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills