Stability AI MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Optionally stores generated images in Google Cloud Storage when running in SSE mode, allowing the server to be deployed for third-party usage over HTTP.

¿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

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.

Nombre de la herramientaDescripciónCosto estimado de la API de estabilidad
generate-imageGenere una imagen de alta calidad de cualquier cosa según una solicitud proporcionada y otros parámetros opcionales.$0.03
generate-image-sd35Genere una imagen utilizando modelos Stable Diffusion 3.5 con opciones de configuración avanzadas.$0.04-$0.07
remove-backgroundEliminar el fondo de una imagen.$0.02
outpaintAmplíe una imagen en cualquier dirección manteniendo la consistencia visual.$0.04
search-and-replaceReemplace objetos o elementos en una imagen describiendo qué reemplazar y con qué reemplazarlo.$0.04
upscale-fastMejora la resolución de la imagen 4x.$0.01
upscale-creativeMejora la resolución de la imagen hasta 4K.$0.25
control-sketchTraduzca un boceto dibujado a mano a una imagen de calidad de producción.$0.03
control-styleGenerar una imagen en el estilo de una imagen de referencia.$0.04
control-structureGenerar una imagen manteniendo la estructura de una imagen de referencia.$0.03
replace-background-and-relightReemplazar el fondo de una imagen y volver a iluminarla.$0.08
search-and-recolorBuscar y cambiar el color de 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 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

Hoja de trucos

Variable de entornoDescripciónRequeridoValor predeterminadoEjemplo
STABILITY_AI_API_KEYTu clave API de Stability AI. Consíguela en platform.stability.aiYN / Ask-1234567890
IMAGE_STORAGE_DIRECTORYDirectorio donde se guardarán las imágenes generadasnorte/tmp/tadasant-mcp-server-stability-ai C:\\Windows\\Temp\\mcp-server-stability-ai/Users/admin/Downloads/stability-ai-images
GCS_PROJECT_IDID de proyecto de Google Cloud para almacenar imágenesN (Y si se usa SSE)N / Ayour-project-id
GCS_CLIENT_EMAILCorreo electrónico del cliente de la cuenta de Google Cloud Service para almacenar imágenesN (Y si se usa SSE)N / Ayour-service-account@project.iam.gserviceaccount.com
GCS_PRIVATE_KEYClave privada de la cuenta de Google Cloud Service para almacenar imágenesN (Y si se usa SSE)N / A-----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n
GCS_BUCKET_NAMENombre del depósito de Google Cloud Storage para almacenar imágenesN (Y si se usa SSE)N / Ayour-bucket-name

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:

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

Reinicie Claude Desktop y estará listo para comenzar:

Instalación mediante herrería

Para instalar Claude Desktop automáticamente a través de 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 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 últimos modelos Stable Diffusion 3.5

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor MCP que se integra con la API de Stability AI para brindar capacidades de generación, edición y manipulación de imágenes de alta calidad, que incluyen eliminación de fondo, pintura, búsqueda y reemplazo, y aumento de escala.

  1. Highlights
    1. Capabilities
      1. Usage Tips
        1. Examples
          1. Generate an image
          2. Generate an image with SD3.5
          3. Remove background
          4. Outpaint (Uncrop)
          5. Search and Replace
          6. Upscale
          7. Control Sketch
          8. Control Style
          9. Control Structure
          10. Replace Background and Relight
          11. Search and Recolor
        2. Setup
          1. Cheatsheet
          2. Claude Desktop
          3. SSE Mode
          4. Roadmap
        3. Contributing
          ID: arwjcxkkhg