Image Generation MCP Server

Servidor MCP de Geração de Imagens

Este servidor MCP fornece capacidades de geração de imagens usando o modelo Replicate Flux.

Instalação

Instalando via Smithery

Para instalar o Image Generation MCP Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @GongRzhe/Image-Generation-MCP-Server --client claude

Opção 1: Método NPX (Sem Configuração Local Necessária)

Você pode usar o pacote diretamente do npm sem instalá-lo localmente:

# No installation needed - npx will handle it

Opção 2: Instalação Local

Se você preferir uma instalação local:

# Global installation
npm install -g @gongrzhe/image-gen-server

# Or local installation
npm install @gongrzhe/image-gen-server

Configuração

Configurar o Claude Desktop

Edite o arquivo de configuração do seu Claude Desktop:

• No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• No Windows: %APPDATA%/Claude/claude_desktop_config.json

Opção 1: Configuração NPX (Recomendado)

Este método executa o servidor diretamente do npm sem precisar de arquivos locais:

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["@gongrzhe/image-gen-server"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Opção 2: Configuração de Instalação Local

Se você instalou o pacote localmente:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Obtenha seu Token da API do Replicate

1. Cadastre-se/faça login em https://replicate.com
2. Vá para https://replicate.com/account/api-tokens
3. Crie um novo token de API
4. Copie o token e substitua your-replicate-api-token nas configurações do MCP

Variáveis de Ambiente

• REPLICATE_API_TOKEN (obrigatório): Seu token da API do Replicate para autenticação
• MODEL (opcional): O modelo Replicate a ser usado para geração de imagens. O padrão é "black-forest-labs/flux-schnell"

Parâmetros de Configuração

• disabled: Controla se o servidor está habilitado (false) ou desabilitado (true)
• autoApprove: Matriz de nomes de ferramentas que podem ser executadas sem confirmação do usuário. Matriz vazia significa que todas as chamadas de ferramentas exigem confirmação.

Ferramentas Disponíveis

generate_image

Gera imagens usando o modelo Flux com base em prompts de texto.

Parâmetros

• prompt (obrigatório): Descrição em texto da imagem a ser gerada
• seed (opcional): Semente aleatória para geração reproduzível
• aspect_ratio (opcional): Proporção de aspecto da imagem (padrão: "1:1")
• output_format (opcional): Formato de saída - "webp", "jpg" ou "png" (padrão: "webp")
• num_outputs (opcional): Número de imagens a gerar (1-4, padrão: 1)

Exemplo de Uso

const result = await use_mcp_tool({
  server_name: "image-gen",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "16:9",
    output_format: "png",
    num_outputs: 1
  }
});

A ferramenta retorna uma matriz de URLs para as imagens geradas.

📜 Licença

Este projeto está licenciado sob a Licença MIT.