Stability AI

Se integra con la API de Stability AI para generación, edición y mejora de imágenes.

GitHub

Documentación

Stability AI MCP Server

¿Aún no has oído hablar de MCP? La forma más fácil de mantenerse al día es leer nuestro boletín semanal en PulseMCP.

Este es un servidor MCP (Model Context Protocol) que integra clientes MCP con las funcionalidades de manipulación de imágenes más recientes y avanzadas de Stability AI: generar, editar, ampliar y más.

Stability AI es un proveedor líder de modelos de IA y este servidor se conecta directamente a su API REST alojada. Necesitarás registrarte para obtener una clave de API de stability.ai para comenzar.

Ofrecen 25 créditos gratis. Después, el precio de pago por uso es muy razonable: $0.01/crédito, donde 3 créditos te dan una generación de imagen en su modelo Core. Así que 100 imágenes de alta calidad = solo $3.

Este proyecto NO está afiliado oficialmente con Stability AI.

Video de demostración, y un adelanto aquí:

Teaser

Tabla de Contenidos

Aspectos destacados
Capacidades
Consejos de uso
Ejemplos
Configuración
- Hoja de referencia
- Claude Desktop
  - Configuración manual

Aspectos destacados

Sin curva de aprendizaje: Este servidor está diseñado para usar valores predeterminados sensatos y proporcionar una experiencia de usuario simple y fluida para las acciones más comunes relacionadas con la generación y manipulación de archivos de imagen. No necesitas ser técnico ni entender nada sobre modelos de imagen para usarlo de manera efectiva.

Encadenar manipulaciones: Puedes generar una imagen, luego reemplazar un elemento dentro de ella, luego eliminar el fondo... todo en una sola conversación de Claude.

Configuración mínima: Todo lo que necesitas para comenzar es una clave de API de Stability AI. Configura variables de entorno para eso y una ruta de directorio local para almacenar las imágenes de salida, y estarás listo.

Aprovecha los mejores modelos de imagen de su clase: Stability AI es el proveedor líder de modelos de imagen expuestos vía API. Usar este servidor los integra en Claude u otro cliente MCP - muy por encima de una experiencia como usar modelos DALL-E en ChatGPT.

Capacidades

Este servidor está construido y probado en macOS con Claude Desktop. Debería funcionar también con otros clientes MCP.

Tool Name	Description	Estimated Stability API Cost
`generate-image`	Genera una imagen de alta calidad de cualquier cosa basada en un prompt proporcionado y otros parámetros opcionales.	$0.03
`generate-image-sd35`	Genera una imagen usando modelos Stable Diffusion 3.5 con opciones de configuración avanzadas.	$0.04-$0.07
`remove-background`	Elimina el fondo de una imagen.	$0.02
`outpaint`	Extiende una imagen en cualquier dirección manteniendo la consistencia visual.	$0.04
`search-and-replace`	Reemplaza objetos o elementos en una imagen describiendo qué reemplazar y con qué reemplazarlo.	$0.04
`upscale-fast`	Mejora la resolución de la imagen 4x.	$0.01
`upscale-creative`	Mejora la resolución de la imagen hasta 4K.	$0.25
`control-sketch`	Convierte un boceto dibujado a mano en una imagen de calidad de producción.	$0.03
`control-style`	Genera una imagen en el estilo de una imagen de referencia.	$0.04
`control-structure`	Genera una imagen manteniendo la estructura de una imagen de referencia.	$0.03
`replace-background-and-relight`	Reemplaza el fondo de una imagen y vuelve a iluminarla.	$0.08
`search-and-recolor`	Busca y recolorea objetos en una imagen.	$0.05

Consejos de uso

Todas las imágenes procesadas se guardan automáticamente en IMAGE_STORAGE_DIRECTORY, se abren para vista previa y se ponen a disposición como recursos.
No intentes copiar/pegar o subir archivos de imagen a Claude. Claude no almacena imágenes en ningún lugar, por lo que no podemos trabajar con ellas con el servidor MCP. Tienen que ser "subidas" (guardadas) en IMAGE_STORAGE_DIRECTORY y luego aparecerán como recursos disponibles en el chat.
Puedes usar los Prompts que vienen precargados en lugar de escribir tu propio texto:

Ejemplos

Generar una imagen

Generate an image of a cat
Generate a photorealistic image of a cat in a cyberpunk city, neon lights reflecting off its fur, 16:9 aspect ratio
Generate a detailed digital art piece of a cat wearing a space suit floating through a colorful nebula, style preset: digital-art, aspect ratio: 21:9

Generar una imagen con SD3.5

Generate an image of a woman with cybernetic wolf ears using the SD3.5 model, with the "neon-punk" style preset
Generate an image of a futuristic city using the SD3.5 Large Turbo model, with aspect ratio 16:9
Generate an image of an astronaut on mars using the SD3.5 Large model, with cfg scale 7.5, "analog-film" style preset, and seed 42

Eliminar fondo

Remove the background from the image I just generated
Remove the background from product-photo.jpg to prepare it for my e-commerce site
Remove the background from group-photo.png so I can composite it with another image

Outpaint (Uncrop)

Extend vacation-photo.jpg 500 pixels to the right to include more of the beach
Extend family-portrait.png 300 pixels up to show more of the mountains, and 200 pixels right to include more landscape
Extend artwork.png in all directions to create a wider fantasy forest scene that matches the original environment

Buscar y Reemplazar

In my last image, replace the red car with a blue car
In portrait.png, replace the plain background with a sunset over mountains
In landscape.jpg, replace the modern buildings with victorian-era architecture while maintaining the same atmosphere

Mejorar resolución

Upscale profile-pic.jpg for better resolution
Upscale product-photo.png to make it print-ready

Y luego, si la salida aún no es lo suficientemente buena, puedes ampliarla de nuevo:

Try again with better quality

Control de Boceto

Transform sketch.png into a colored illustration for a children's book
Convert wireframe.jpg into a detailed 3D render for a modern architectural visualization

Control de Estilo

Generate an image in the style of the reference image

Control de Estructura

Generate an image while maintaining the structure of the reference image

Reemplazar Fondo y Reiluminar

Replace the background of the image I just generated with a sunset over mountains

Buscar y Recolorear

In my last image, make the red car be blue instead

Configuración

Registro de Metadatos

El servidor puede guardar metadatos de las solicitudes de generación de imágenes para ayudar con el seguimiento y la resolución de problemas.

Environment Variable	Description	Required	Default Value
`SAVE_METADATA`	Guardar metadatos para generaciones de imágenes exitosas	No	`true`
`SAVE_METADATA_FAILED`	Guardar metadatos para generaciones de imágenes fallidas	No	`false`

Cuando está habilitado, se creará un archivo .txt con el mismo nombre que la imagen generada en el mismo directorio. Este archivo contiene:

Marca de tiempo de la solicitud
Todos los parámetros de la solicitud (prompt, modelo, preajuste de estilo, etc.)
Información de respuesta (estado de éxito, tiempo de generación)

Este archivo también se creará para solicitudes fallidas si SAVE_METADATA_FAILED está habilitado.

Hoja de referencia

Environment Variable	Description	Required	Default Value	Example
`STABILITY_AI_API_KEY`	Tu clave de API de Stability AI. Obtén una en platform.stability.ai	Sí	N/A	`sk-1234567890`
`IMAGE_STORAGE_DIRECTORY`	Directorio donde se guardarán las imágenes generadas	No	`/tmp/tadasant-mcp-server-stability-ai` OR `C:\\Windows\\Temp\\mcp-server-stability-ai`	`/Users/admin/Downloads/stability-ai-images` (Mac OS/Linux), `C:\\Users\\Admin\\Downloads\\stability-ai-images` (Windows)
`SAVE_METADATA`	Guardar metadatos para generaciones de imágenes exitosas	No	`true`	`true` or `false`
`SAVE_METADATA_FAILED`	Guardar metadatos para generaciones de imágenes fallidas	No	`true`	`true` or `false`
`GCS_PROJECT_ID`	ID del proyecto de Google Cloud para almacenar imágenes	No (Sí si se usa SSE)	N/A	`your-project-id`
`GCS_CLIENT_EMAIL`	Correo electrónico del cliente de la cuenta de servicio de Google Cloud para almacenar imágenes	No (Sí si se usa SSE)	N/A	`your-service-account@project.iam.gserviceaccount.com`
`GCS_PRIVATE_KEY`	Clave privada de la cuenta de servicio de Google Cloud para almacenar imágenes	No (Sí si se usa SSE)	N/A	`-----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n`
`GCS_BUCKET_NAME`	Nombre del bucket de Google Cloud Storage para almacenar imágenes	No (Sí si se usa SSE)	N/A	`your-bucket-name`

Claude Desktop

Si prefieres un tutorial en video, aquí tienes uno rápido.

Crea una carpeta de directorio en algún lugar de tu máquina para almacenar imágenes generadas/modificadas. Algunas opciones:

/Users/<username>/Downloads/stability-ai-images
/Users/<username>/Library/Application Support/Claude/mcp-server-stability-ai/images

Y asegúrate de tener una clave de API de Stability AI.

Luego procede a tu método preferido de configuración del servidor a continuación. Si es la primera vez que usas servidores MCP, querrás asegurarte de tener la aplicación Claude Desktop y seguir las instrucciones oficiales de configuración de MCP.

Configuración manual

Vas a necesitar Node funcionando en tu máquina para poder ejecutar comandos npx en tu terminal. Si no tienes Node, puedes instalarlo desde nodejs.org.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Modifica tu archivo claude_desktop_config.json para agregar lo siguiente:

{
  "mcpServers": {
    "stability-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-stability-ai"
      ],
      "env": {
        "STABILITY_AI_API_KEY": "sk-1234567890"
      }
    }
  }
}

Reinicia Claude Desktop y deberías estar listo para comenzar:

Instalación mediante Smithery

Para instalar automáticamente para Claude Desktop mediante Smithery:

npx @smithery/cli install mcp-server-stability-ai --client claude

Modo SSE

Este servidor tiene la opción de ejecutarse en modo SSE iniciándolo con el siguiente comando:

npx mcp-server-stability-ai -y --sse

Este modo es útil si tienes la intención de implementar este servidor para uso de terceros a través de HTTP. Deberá configurar las variables de entorno GCS_PROJECT_ID, GCS_CLIENT_EMAIL, GCS_BUCKET_NAME y GCS_PRIVATE_KEY, porque el servidor almacenará los archivos de imagen en Google Cloud Storage en lugar de su sistema de archivos local.

Tenga en cuenta que el esquema de multiinquilino es muy ingenuo e inseguro: utiliza la dirección IP del solicitante para segmentar los prefijos de GCS utilizados para almacenar las imágenes, y hace que todas las imágenes sean públicamente accesibles para poder comunicarlas de vuelta al cliente MCP. Así que, en teoría, si alguien conoce su dirección IP y los nombres de los archivos que generó, podría acceder a sus imágenes adivinando la URL.

Hoja de ruta

Completado recientemente:

✅ Se agregó soporte para modelos Stable Diffusion 3.5
✅ Se agregó soporte para Stable Image Ultra
✅ Se agregó registro de metadatos para solicitudes de generación de imágenes

Estas funciones llegarán pronto; ¡pero las PR son bienvenidas! Consulte CONTRIBUTING.md.

inpaint - Una versión más precisa de las funcionalidades de search-and-x, requiere gestionar una máscara para definir el área a reemplazar.
Manipulación básica de imágenes (recortar, rotar, redimensionar, etc.): probablemente como su propio servidor MCP
Capacidad de inpaint una imagen dentro de otra imagen. No parece posible con la API de Stability; probablemente se necesitará otro servidor MCP que use una API diferente para lograr esto.
Cliente MCP hecho a medida para manipulación de imágenes

Contribuciones

¡Las contribuciones externas son bienvenidas! Consulte CONTRIBUTING.md para más detalles.

También siéntase libre de plantear problemas o solicitudes de funciones; nos encanta ver cómo la gente usa esto y cómo podría mejorarse.