Replicate Designer

Replicate Designer MCP

Um servidor MCP para gerar imagens usando o modelo Flux 1.1 Pro da Replicate.

Instalação

Usando Diretamente do GitHub

Você pode usar o servidor MCP diretamente do GitHub de várias maneiras:

Opção 1: Instalar diretamente com pip

pip install git+https://github.com/yourusername/replicate-designer.git

Em seguida, execute com:

mcp-replicate-designer

Opção 2: Usar npx com repositório do GitHub

Crie um arquivo de configuração (por exemplo, mcps.json):

{
  "mcpServers": {
    "replicateDesigner": {
      "command": "npx",
      "args": [
        "-y", 
        "github:yourusername/replicate-designer"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_api_token_here"
      }
    }
  }
}

Em seguida, use com Claude ou outro assistente:

npx @anthropic-ai/assistant --mcps-json mcps.json

Este método permite incluir seu token de API da Replicate diretamente no arquivo de configuração, o que é mais conveniente do que definir variáveis de ambiente separadamente.

Opção 3: Instalação Local

Clone o repositório e instale a partir do diretório local:

git clone https://github.com/yourusername/replicate-designer.git
cd replicate-designer
pip install -e .

Publicando e Usando via npm

Para disponibilizar seu MCP via npm (para distribuição mais fácil):

1. Empacote e publique seu MCP:

# Build a wheel
pip install build
python -m build

# Publish to npm (after setting up an npm account)
npm init
npm publish

2. Em seguida, os usuários podem instalar e usar diretamente:

npx -y mcp-replicate-designer

Uso

Definindo o Token da API

Existem várias maneiras de fornecer seu token de API da Replicate:

1. Variável de ambiente (para uso na linha de comando):

   export REPLICATE_API_TOKEN=your_api_token_here
   

2. No arquivo de configuração do MCP (como mostrado na Opção 2 acima):

   {
     "mcpServers": {
       "replicateDesigner": {
         "command": "...",
         "args": ["..."],
         "env": {
           "REPLICATE_API_TOKEN": "your_replicate_api_token_here"
         }
       }
     }
   }
   

3. Usando um arquivo .env no diretório do seu projeto:

   REPLICATE_API_TOKEN=your_api_token_here
   

   Em seguida, instale o pacote python-dotenv:

   pip install python-dotenv
   

Nota de Segurança: Tenha cuidado com seus tokens de API. Nunca os envie para repositórios públicos e use variáveis de ambiente ou gerenciamento seguro de segredos quando possível.

Executando o servidor MCP

mcp-replicate-designer

Por padrão, ele executa no modo stdio, que é compatível com o uso via npx. Você também pode executá-lo no modo SSE:

mcp-replicate-designer --transport sse --port 8000

Usando com npx

Este MCP pode ser usado com um agente de IA usando npx de duas maneiras:

Linha de comando direta

npx @anthropic-ai/assistant --mcp mcp-replicate-designer

Como objeto de configuração

No seu JSON de configuração:

{
  "mcpServers": {
    "replicateDesigner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-replicate-designer"
      ]
    }
  }
}

Em seguida, use com:

npx @anthropic-ai/assistant --mcps-json /path/to/your/config.json

Ferramenta

Este MCP expõe uma única ferramenta:

generate_image

Gera uma imagem usando o modelo Flux 1.1 Pro da Replicate.

Parâmetros:

• prompt (string, obrigatório): Descrição textual da imagem a ser gerada
• aspect_ratio (string, opcional, padrão: "1:1"): Proporção de aspecto da imagem gerada
• output_format (string, opcional, padrão: "webp"): Formato da imagem de saída
• output_quality (inteiro, opcional, padrão: 80): Qualidade da imagem de saída (1-100)
• safety_tolerance (inteiro, opcional, padrão: 2): Nível de tolerância de segurança (0-3)
• prompt_upsampling (booleano, opcional, padrão: true): Se deve usar upsampling de prompt

Exemplo:

{
  "prompt": "A photograph of an humanoid AI agent looking sad and in disrepair, the agent is sat at a workbench getting fixed by a human male",
  "aspect_ratio": "1:1",
  "output_format": "webp"
}