Stability AI MCP Server

¿Aún no conoces MCP? La forma más fácil de mantenerte al día es leyendo nuestro boletín semanal en PulseMCP .

Este es un servidor MCP ( Protocolo de contexto de modelo ) que integra clientes MCP con las últimas y más excelentes funcionalidades de manipulación de imágenes de difusión estable 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 . Para comenzar, deberá registrarse para obtener una clave API de Stability.ai .

Ofrecen 25 créditos gratis. Después, el precio de pago por uso es muy razonable: $0.01 por crédito, y con 3 créditos se genera una imagen en su modelo Core. Así que 100 imágenes de alta calidad cuestan solo $3.

Este proyecto NO está afiliado oficialmente con Stability AI.

Vídeo de demostración y un adelanto aquí:

Tabla de contenido

• Reflejos
• Capacidades
• Consejos de uso
• Ejemplos
• Configuración
  • Hoja de trucos
  • Escritorio de Claude
    • Configuración manual

Reflejos

Sin curva de aprendizaje : Este servidor está diseñado para usar valores predeterminados sensatos y proporcionar una experiencia de usuario sencilla y fluida para las acciones más comunes relacionadas con la generación y manipulación de archivos de imagen. No necesita conocimientos técnicos ni conocimientos de modelos de imagen para usarlo eficazmente.

Manipulaciones en cadena : 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 : Solo necesitas una clave API de Stability AI. Define las variables de entorno y una ruta de directorio local para almacenar las imágenes de salida, ¡y listo!

Aproveche los mejores modelos de imagen : Stability AI es el proveedor líder de modelos de imagen expuestos mediante API. Al usar este servidor, se integran en Claude u otro cliente MCP, una experiencia superior a la del uso de modelos DALL-E en ChatGPT.

Capacidades

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

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 intente copiar/pegar ni subir imágenes a Claude. Claude no almacena imágenes en ningún sitio, por lo que no podemos trabajar con ellas en el servidor MCP. Deben subirse (guardarse) en el IMAGE_STORAGE_DIRECTORY y luego aparecerán como recursos disponibles en el chat.
• Puede utilizar los mensajes que vienen precargados en lugar de escribir su propio texto:

Ejemplos

Generar una imagen

1. Generate an image of a cat
2. Generate a photorealistic image of a cat in a cyberpunk city, neon lights reflecting off its fur, 16:9 aspect ratio
3. 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

1. Generate an image of a woman with cybernetic wolf ears using the SD3.5 model, with the "neon-punk" style preset
2. Generate an image of a futuristic city using the SD3.5 Large Turbo model, with aspect ratio 16:9
3. 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

Quitar el fondo

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

Pintar (sin recortar)

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

Buscar y reemplazar

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

De lujo

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

Y luego, si el resultado aún no es lo suficientemente bueno, puedes ampliarlo nuevamente:

1. Try again with better quality

Boceto de control

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

Estilo de control

1. Generate an image in the style of the reference image

Estructura de control

1. Generate an image while maintaining the structure of the reference image

Reemplazar el fondo y volver a iluminar

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

Buscar y recolorear

1. 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.

Al habilitar esta opción, 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 solicitud (mensaje, modelo, estilo preestablecido, 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 trucos

Escritorio de Claude

Si prefieres un videotutorial, aquí tienes uno rápido .

Cree un directorio de carpetas en su equipo para almacenar las imágenes generadas o modificadas. Algunas opciones:

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

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

Luego, proceda a su método preferido para configurar el servidor, como se indica a continuación. Si es la primera vez que utiliza servidores MCP, asegúrese de tener la aplicación Claude Desktop y siga las instrucciones oficiales de configuración de MCP .

Configuración manual

Necesitarás tener Node instalado en tu equipo 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

Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Modifique su archivo claude_desktop_config.json para agregar lo siguiente:

Reinicie Claude Desktop y estará listo para comenzar:

Instalación mediante herrería

Para instalar Claude Desktop automáticamente a través de Smithery :

Modo SSE

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

Este modo es útil si desea implementar este servidor para uso de terceros a través de HTTP.

Necesitará configurar las variables de entorno GCS_PROJECT_ID , GCS_CLIENT_EMAIL , GCS_BUCKET_NAME y GCS_PRIVATE_KEY , porque el servidor almacenará archivos de imagen en Google Cloud Storage en lugar de en su sistema de archivos local.

Tenga en cuenta que el esquema multiusuario es muy ingenuo e inseguro: utiliza la dirección IP del solicitante para segmentar los prefijos GCS utilizados para almacenar las imágenes y las hace públicas para comunicarlas al cliente MCP. Por lo tanto, en teoría, si alguien conoce su dirección IP y el nombre de los archivos que generó, podría acceder a sus imágenes adivinando la URL.

Hoja de ruta

Recientemente completado:

• ✅ Se agregó soporte para los 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

Próximamente, ¡pero se agradecen las relaciones públicas! Consulta CONTRIBUTING.md .

• inpaint : una versión más precisa de las funcionalidades search-and-x , que requiere la administración de una máscara para definir el área a reemplazar.
• Manipulación de imágenes base (recortar, rotar, redimensionar, etc.): probablemente como su propio servidor MCP
• Posibilidad de repintar una imagen dentro de otra. No parece posible con la API de estabilidad; probablemente se necesite otro servidor MCP que acceda a una API diferente para lograrlo.
• Cliente MCP personalizado para la manipulación de imágenes

Contribuyendo

¡Agradecemos las contribuciones externas! Para más información, consulte CONTRIBUTING.md .

También no dudes en plantear problemas o solicitudes de funciones; me encanta ver cómo la gente usa esto y cómo se podría mejorar.