Flux Image MCP Server

Gere imagens usando o modelo Flux Schnell da Replicate.

Documentação

Flux Image MCP Server

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

Instalação

  1. Instale o MCP SDK globalmente:
npm install -g @modelcontextprotocol/sdk@latest
  1. Clone este repositório para o seu diretório de servidores MCP:
cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install
  1. Compile o servidor:
npm run build
  1. Adicione a configuração do servidor ao seu arquivo de configurações MCP (global ou do workspace):
{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Configuração

O servidor requer a seguinte variável de ambiente:

Uso

Uma vez instalado e configurado, o servidor fornece a seguinte ferramenta:

generate_image

Gera uma imagem usando o modelo Flux Schnell com base em um prompt de texto.

Parâmetros:

  • prompt (string, obrigatório): Descrição textual da imagem desejada

Exemplo de uso:

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

A ferramenta retornará uma resposta JSON contendo:

  • status: O status da solicitação de geração
  • output: A URL da imagem gerada (se bem-sucedida)
  • error: Qualquer mensagem de erro (se falhar)

Desenvolvimento

Para fazer alterações no servidor:

  1. Modifique o código-fonte em src/index.ts
  2. Recompile o servidor: npm run build
  3. Reinicie o servidor MCP para que as alterações tenham efeito

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

  • Token de API ausente
  • Parâmetros inválidos
  • Falhas em solicitações de API
  • Problemas de rede

Segurança

  • Nunca envie seu token da API do Replicate para o controle de versão
  • Sempre forneça o token por meio de variáveis de ambiente
  • O servidor valida todos os parâmetros de entrada antes de fazer solicitações à API