Flux ImageGen MCP Server

Um servidor MCP para gerar imagens usando a API Pollinations AI.

Documentação

Servidor MCP de Geração de Imagens Flux

Um servidor especializado do Model Context Protocol (MCP) para geração e manipulação de imagens, alimentado pela Pollinations AI.

Desenvolvedor

Autor: Falah.G.Salieh
Direitos autorais: © 2025 Todos os direitos reservados

Visão Geral

O ImageGen MCP Server é uma implementação simplificada de servidor que fornece poderosas capacidades de geração de imagens por meio do Model Context Protocol (MCP). Este servidor é especializado em três funcionalidades principais:

Geração de URL de Imagem
Geração Direta de Imagem
Listagem e Gerenciamento de Modelos

Recursos

🖼️ Geração de Imagens: Crie imagens impressionantes a partir de prompts de texto
🎨 Múltiplos Modelos: Suporte para vários modelos de geração de imagens
🔧 Configuração Flexível: Fácil de configurar e personalizar
🚀 Alto Desempenho: Otimizado para tempos de resposta rápidos
🔄 Compatível com MCP: Totalmente compatível com o Model Context Protocol

Instalação

# Clone the repository
git clone https://github.com/yourusername/flux-imagegen-mcp-server.git

# Install dependencies
npm install

Configuração

Configuração do Claude Desktop

Para usar este servidor com o Claude Desktop, atualize seu arquivo de configuração em: C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpollinations": {
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "PATH_TO_YOUR_SERVER\\server.js"
      ],
      "tools": [
        "generateImageUrl",
        "generateImage",
        "listImageModels"
      ]
    }
  }
}

Substitua PATH_TO_YOUR_SERVER pelo caminho real do seu servidor.

Ferramentas Disponíveis

1. Gerar URL de Imagem (`generateImageUrl`)

Gera uma URL para uma imagem com base em um prompt de texto.

{
  "prompt": "A beautiful sunset over mountains",
  "model": "flux",  // optional, defaults to 'flux'
  "width": 1024,    // optional
  "height": 1024,   // optional
  "enhance": true,  // optional
  "safe": false     // optional
}

2. Gerar Imagem (`generateImage`)

Gera e salva uma imagem diretamente a partir de um prompt de texto.

{
  "prompt": "A serene lake reflecting mountains",
  "model": "flux",
  "width": 1024,
  "height": 1024,
  "enhance": true,
  "safe": false,
  "outputPath": "./output",
  "fileName": "mountain_lake",
  "format": "png"
}

3. Listar Modelos de Imagem (`listImageModels`)

Retorna uma lista dos modelos de geração de imagens disponíveis.

// Example response:
{
  "models": [
    {
      "id": "flux",
      "name": "Flux",
      "description": "Default image generation model"
    },
    // ... other models
  ]
}

Executando o Servidor

# Start the server
node server.js

Requisitos de Ambiente

Node.js >= 16.0.0
NPM >= 7.0.0
Compatível com Windows/Linux/MacOS

Desenvolvimento

Para contribuir ou modificar o servidor:

Faça um fork do repositório
Crie sua branch de funcionalidade
Faça suas alterações
Envie um pull request

Tratamento de Erros

O servidor fornece mensagens de erro detalhadas para problemas comuns:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": { /* Additional error details */ }
  }
}

Exemplos

Geração Básica de Imagem

// Generate an image URL
const response = await generateImageUrl({
  prompt: "A futuristic city at night",
  model: "flux",
  width: 1024,
  height: 1024
});

// Generate and save an image
const image = await generateImage({
  prompt: "A peaceful garden with butterflies",
  outputPath: "./images",
  fileName: "garden_scene"
});

Exemplo de Download de Imagem

// Download an image from URL
const downloadResult = await downloadImage({
  imageUrl: "https://example.com/image.jpg",
  fileName: "downloaded-image",
  format: "png"
});

Suporte

Para problemas e solicitações de recursos, crie uma issue no repositório ou entre em contato com o desenvolvedor:

E-mail: [Seu e-mail de contato]
GitHub: [Seu perfil no GitHub]

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.