Flux Schnell MCP Server

Flux Schnell MCP Server

Um servidor baseado em MCP (Model Context Protocol) para gerar imagens chamando o modelo Flux Schnell através da API Replicate.

Recursos

• Fornece a ferramenta generate_image para gerar imagens
• Suporta prompts de texto personalizados
• Lida automaticamente com a comunicação com a API Replicate
• Tratamento completo de erros e respostas

Pré-requisitos

1. Node.js (v14 ou superior)
2. Token da API Replicate
3. Ambiente compatível com MCP (como Claude Desktop)

Obtendo o Token da API Replicate

1. Acesse o site oficial da Replicate e registre uma conta
2. Após o login, acesse a página de API Tokens
3. Clique em "Create API token" para criar um novo token
4. Copie o token gerado (formato: r8_xxxxxx)

Instalação

1. Clone o projeto e instale as dependências:

git clone [repository-url]
cd flux-schnell-mcp
npm install

2. Compile o servidor:

npm run build

Configuração

Configuração do Claude Desktop

1. Abra o arquivo de configuração:

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

2. Adicione a configuração do servidor:

{
  "mcpServers": {
    "flux-schnell": {
      "command": "node",
      "args": ["/path/to/flux-schnell-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Configuração do VSCode Roo

1. Abra o arquivo de configuração:

   • Linux: ~/.vscode-remote/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • MacOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

2. Adicione a mesma configuração de servidor descrita acima.

Como usar

O servidor fornece uma ferramenta chamada generate_image, que pode ser chamada via MCP:

<use_mcp_tool>
<server_name>flux-schnell</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "a beautiful sunset over the ocean, digital art style"
}
</arguments>
</use_mcp_tool>

Descrição dos parâmetros

• prompt: descrição textual para gerar a imagem (obrigatório)
  • Recomenda-se usar descrições detalhadas para obter melhores resultados
  • Pode incluir informações como estilo, cena, detalhes, etc.

Formato da resposta

O servidor retornará a resposta completa da API Replicate, incluindo a URL da imagem gerada e outros metadados.

Depuração

Como o servidor MCP se comunica via stdio, a depuração pode ser difícil. Recomenda-se usar o MCP Inspector:

npm run inspector

O Inspector fornecerá uma URL que pode ser acessada no navegador para usar a ferramenta de depuração.

Observações

1. Guarde seu Token da API Replicate com segurança e não o compartilhe com outras pessoas
2. Certifique-se de usar os caminhos de arquivo corretos no arquivo de configuração
3. A geração de imagens pode levar algum tempo; aguarde a resposta com paciência
4. Se encontrar erros, verifique se o Token da API está correto e se a conexão de rede está funcionando