Stability AI

Integra com a API do Stability AI para geração, edição e ampliação de imagens.

GitHub
84

Documentação


Stability AI MCP Server

Smithery Badge

PulseMCP Badge

Ainda não ouviu falar de MCP? A maneira mais fácil de se manter atualizado é ler nossa newsletter semanal na PulseMCP.

Este é um servidor MCP (Model Context Protocol) que integra clientes MCP com as mais recentes e melhores funcionalidades de manipulação de imagens Stable Diffusion da Stability AI: gerar, editar, ampliar e muito mais.

A Stability AI é uma provedora líder de modelos de IA e este servidor se conecta diretamente à API REST hospedada deles. Você precisará se cadastrar para obter uma chave de API em stability.ai para começar.

Eles oferecem 25 créditos gratuitos. Depois disso, o preço pré-pago é muito razoável: $0.01/crédito, onde 3 créditos geram uma imagem no modelo Core. Ou seja, 100 imagens de alta qualidade = apenas $3.

Este projeto NÃO é oficialmente afiliado à Stability AI.

Vídeo de demonstração, e um teaser aqui:

Teaser


Sumário

Destaques

Sem curva de aprendizado: Este servidor foi projetado para usar padrões sensatos e fornecer uma experiência de usuário simples e fluida para as ações mais comuns relacionadas à geração e manipulação de arquivos de imagem. Você não precisa ser técnico nem entender nada sobre modelos de imagem para usá-lo de forma eficaz.

Encadeie manipulações: Você pode gerar uma imagem, depois substituir um item dentro dela, depois remover o fundo... tudo em uma única conversa com o Claude.

Configuração mínima: Tudo o que você precisa para começar é uma chave de API da Stability AI. Defina variáveis de ambiente para isso e um caminho de diretório local para armazenar as imagens de saída, e você estará pronto.

Aproveite os melhores modelos de imagem da categoria: A Stability AI é a principal provedora de modelos de imagem expostos via API. Usar este servidor os integra ao Claude ou a outro cliente MCP — muito superior a uma experiência como usar os modelos DALL-E no ChatGPT.

Recursos

Este servidor foi construído e testado no macOS com o Claude Desktop. Ele deve funcionar também com outros clientes MCP.

Nome da FerramentaDescriçãoCusto Estimado da API Stability
generate-imageGere uma imagem de alta qualidade de qualquer coisa com base em um prompt fornecido e outros parâmetros opcionais.$0.03
generate-image-sd35Gere uma imagem usando modelos Stable Diffusion 3.5 com opções avançadas de configuração.$0.04-$0.07
remove-backgroundRemova o fundo de uma imagem.$0.02
outpaintEstenda uma imagem em qualquer direção mantendo a consistência visual.$0.04
search-and-replaceSubstitua objetos ou elementos em uma imagem descrevendo o que substituir e pelo que substituir.$0.04
upscale-fastMelhore a resolução da imagem em 4x.$0.01
upscale-creativeMelhore a resolução da imagem até 4K.$0.25
control-sketchTransforme um esboço desenhado à mão em uma imagem de qualidade profissional.$0.03
control-styleGere uma imagem no estilo de uma imagem de referência.$0.04
control-structureGere uma imagem mantendo a estrutura de uma imagem de referência.$0.03
replace-background-and-relightSubstitua o fundo de uma imagem e re-ilumine-a.$0.08
search-and-recolorPesquise e recolorize objetos em uma imagem.$0.05

Dicas de Uso

  • Todas as imagens processadas são salvas automaticamente em IMAGE_STORAGE_DIRECTORY, abertas para visualização e disponibilizadas como recursos
  • Não tente copiar/colar ou enviar arquivos de imagem para o Claude. O Claude não armazena imagens em nenhum lugar, então não podemos trabalhar com elas usando o servidor MCP. Elas precisam ser "enviadas" (salvas em) IMAGE_STORAGE_DIRECTORY e então aparecerão como recursos disponíveis no chat.
  • Você pode usar Prompts pré-carregados em vez de escrever seu próprio texto:
Prompts

Exemplos

Gerar uma imagem

  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

Gerar uma imagem com 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

Remover fundo

  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

Outpaint (Uncrop)

  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

Pesquisar e Substituir

  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

Ampliar (Upscale)

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

E então, se a saída ainda não for boa o suficiente, você pode ampliá-la novamente:

  1. Try again with better quality

Control Sketch

  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

Control Style

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

Control Structure

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

Substituir Fundo e Re-iluminar

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

Pesquisar e Recolorir

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

Configuração

Registro de Metadados

O servidor pode salvar metadados de solicitações de geração de imagens para ajudar no rastreamento e na solução de problemas.

Variável de AmbienteDescriçãoObrigatóriaValor Padrão
SAVE_METADATASalvar metadados de gerações de imagens bem-sucedidasNãotrue
SAVE_METADATA_FAILEDSalvar metadados de gerações de imagens com falhaNãofalse

Quando ativado, um arquivo .txt com o mesmo nome da imagem gerada será criado no mesmo diretório. Este arquivo contém:

  • Carimbo de data/hora da solicitação
  • Todos os parâmetros da solicitação (prompt, modelo, predefinição de estilo, etc.)
  • Informações da resposta (status de sucesso, tempo de geração)

Este arquivo também será criado para solicitações com falha se SAVE_METADATA_FAILED estiver ativado.

Cheatsheet

Variável de AmbienteDescriçãoObrigatóriaValor PadrãoExemplo
STABILITY_AI_API_KEYSua chave de API da Stability AI. Obtenha uma em platform.stability.aiSimN/Ask-1234567890
IMAGE_STORAGE_DIRECTORYDiretório onde as imagens geradas serão salvasNão/tmp/tadasant-mcp-server-stability-ai OU 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_METADATASalvar metadados de gerações de imagens bem-sucedidasNãotruetrue ou false
SAVE_METADATA_FAILEDSalvar metadados de gerações de imagens com falhaNãotruetrue ou false
GCS_PROJECT_IDID do projeto Google Cloud para armazenar imagensNão (Sim se usar SSE)N/Ayour-project-id
GCS_CLIENT_EMAILE-mail do cliente da conta de serviço do Google Cloud para armazenar imagensNão (Sim se usar SSE)N/Ayour-service-account@project.iam.gserviceaccount.com
GCS_PRIVATE_KEYChave privada da conta de serviço do Google Cloud para armazenar imagensNão (Sim se usar SSE)N/A-----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n
GCS_BUCKET_NAMENome do bucket do Google Cloud Storage para armazenar imagensNão (Sim se usar SSE)N/Ayour-bucket-name

Claude Desktop

Se você preferir um tutorial em vídeo, aqui está um rápido.

Crie uma pasta em algum lugar da sua máquina para armazenar imagens geradas/modificadas. Algumas opções:

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

E certifique-se de ter uma chave de API da Stability AI.

Em seguida, prossiga com o método de sua preferência para configurar o servidor abaixo. Se esta é a primeira vez que você usa servidores MCP, certifique-se de ter o aplicativo Claude Desktop e siga as instruções oficiais de configuração do MCP.

Configuração Manual

Você precisará ter o Node funcionando na sua máquina para poder executar comandos npx no seu terminal. Se você não tiver o Node, pode instalá-lo em nodejs.org.

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

Modifique seu arquivo claude_desktop_config.json para adicionar o seguinte:

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

Reinicie o Claude Desktop e você estará pronto para começar:

Claude First Image Claude Second Image

Instalação via Smithery

Para instalar automaticamente para o Claude Desktop via Smithery:

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

Modo SSE

Este servidor tem a opção de executar em modo SSE iniciando-o com o seguinte comando:

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

Este modo é útil se você pretende implantar este servidor para uso por terceiros via HTTP. Você precisará definir as variáveis de ambiente GCS_PROJECT_ID, GCS_CLIENT_EMAIL, GCS_BUCKET_NAME e GCS_PRIVATE_KEY, porque o servidor armazenará os arquivos de imagem no Google Cloud Storage em vez do sistema de arquivos local.

Observe que o esquema de multitenancy é muito ingênuo e inseguro: ele usa o endereço IP do solicitante para segmentar os prefixos do GCS usados para armazenar as imagens e torna todas as imagens publicamente acessíveis para comunicá-las de volta ao cliente MCP. Então, em teoria, se alguém souber seu endereço IP e os nomes dos arquivos que você gerou, essa pessoa poderia acessar suas imagens adivinhando a URL.

Roadmap

Concluído recentemente:

  • ✅ Adicionado suporte para modelos Stable Diffusion 3.5
  • ✅ Adicionado suporte para Stable Image Ultra
  • ✅ Adicionado registro de metadados para solicitações de geração de imagens

Estes estão chegando em breve; mas PRs são bem-vindos! Veja CONTRIBUTING.md.

  • inpaint - Uma versão mais precisa das funcionalidades de search-and-x, requer o gerenciamento de uma máscara para definir a área a ser substituída.
  • Manipulação básica de imagens (cortar, girar, redimensionar, etc.): provavelmente como um servidor MCP próprio
  • Capacidade de fazer inpaint de uma imagem em outra imagem. Não parece possível com a API da Stability; provavelmente será necessário outro servidor MCP usando uma API diferente para conseguir isso.
  • Cliente MCP personalizado para manipulação de imagens

Contribuindo

Contribuições externas são bem-vindas! Veja CONTRIBUTING.md para mais detalhes.

Também fique à vontade para abrir issues ou solicitações de recursos; adoramos ver como as pessoas estão usando isso e como poderia ser melhorado.