Image Generator MCP Server

Servidor MCP de Geração de Imagens

Um servidor Model Context Protocol (MCP) que gera imagens de teste com largura, altura e cor personalizáveis. Salva imagens como arquivos PNG em caminhos de arquivo especificados.

Recursos

• Gera imagens de teste com dimensões especificadas (1-4096 pixels)
• Suporte para formato de cor hexadecimal (ex.: #FF0000, #f00)
• Sobreposição automática de texto mostrando as dimensões da imagem
• Texto de etiqueta personalizado opcional exibido no canto superior esquerdo
• Seleção inteligente de cor de contraste para texto legível
• Salva imagens como arquivos PNG em caminhos de arquivo especificados
• Cria automaticamente diretórios se eles não existirem

Instalação

1. Clone ou baixe este repositório
2. Instale as dependências:

npm install

3. Compile o servidor:

npm run build

4. Adicione o servidor à sua configuração MCP:

Para VSCode:

{
    "servers": {
        "Image Placeholder Gen": {
            "type": "stdio",
            "command": "node",
            "args": [
                "~/mcp_servers/image-gen/build/index.js"
            ]
        }
    }
}

Para Claude Desktop:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen/build/index.js"]
    }
  }
}

Uso

O servidor fornece uma ferramenta:

generate_test_image

Gera uma imagem de teste com parâmetros especificados.

Parâmetros:

• width (número): Largura da imagem em pixels (1-4096)
• height (número): Altura da imagem em pixels (1-4096)
• color (string): Cor da imagem como código hexadecimal (ex.: #FF0000 ou #f00)
• filepath (string): Caminho completo onde a imagem PNG deve ser salva
• label (string, opcional): Texto personalizado para exibir no canto superior esquerdo da imagem

Exemplo:

{
  "name": "generate_test_image",
  "arguments": {
    "width": 400,
    "height": 300,
    "color": "#3498db",
    "filepath": "/tmp/test_image.png",
    "label": "My Custom Label"
  }
}

Retorna:

• Confirmação em texto de que a imagem foi gerada e salva com sucesso

Formato de Cor

A ferramenta suporta formato de cor hexadecimal:

• Cores hexadecimais: #FF0000, #f00

Testes

Execute o script de teste para verificar se o servidor funciona:

npm run build
npm test

Dependências

• Biblioteca canvas do Node.js para geração de imagens
• SDK do Model Context Protocol

Notas

• As dimensões máximas da imagem são limitadas a 4096x4096 pixels por questão de desempenho
• As imagens geradas incluem sobreposição de texto com dimensões para fácil identificação
• A cor do texto é escolhida automaticamente para contraste ideal com o fundo
• O servidor cria automaticamente diretórios se eles não existirem no caminho de arquivo especificado

Contribuição

Sinta-se à vontade para enviar problemas e solicitações de melhorias!