Image MCP Server

Image MCP Server

Um servidor MCP (Model Context Protocol) que fornece capacidades de geração de imagens por IA usando o módulo npm ai-image, que encapsula as APIs de inferência de imagens da OpenAI e Replicate.

Recursos

• generate_ai_image: Gere imagens de IA com prompts, tamanhos, modelos e estilos personalizáveis
• square_image: Gere imagens quadradas (1024x1024) - comando de atalho
• landscape_image: Gere imagens paisagem (1536x1024) - comando de atalho
• portrait_image: Gere imagens retrato (1024x1536) - comando de atalho
• Construído sobre o módulo ai-image para integração perfeita com as APIs da OpenAI e Replicate
• Configuração simples e fácil

Instalação

npm install -g image-mcp

Configuração

Configuração do Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "image-mcp": {
      "command": "npx",
      "args": ["image-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MCP_TIMEOUT": "1200000"
      },
      "resetTimeoutOnProgress": true
    }
  }
}

Variáveis de Ambiente

O servidor requer chaves de API para os serviços subjacentes de geração de imagens:

• OPENAI_API_KEY: Sua chave de API da OpenAI para modelos baseados em GPT (não daremos suporte a modelos Dall-e, pois provavelmente serão descontinuados em breve)
• REPLICATE_API_TOKEN: Seu token da API Replicate para outros modelos de IA

Uso

Uma vez configurado, você pode usar as funções de geração de imagens através do Claude:

generate_ai_image

Gere imagens de IA com vários parâmetros:

• prompt (obrigatório): Descrição em texto da imagem a ser gerada
• size (opcional): Dimensões da imagem no formato LARGURAxALTURA (padrão: "1024x1024")
• model (opcional): Modelo de IA específico a ser usado
• output (opcional): Caminho personalizado do arquivo de saída

Comandos de Atalho

Para conveniência, use estes comandos de tamanho predefinido:

• square_image: Gere imagens quadradas 1024x1024
• landscape_image: Gere imagens paisagem 1536x1024
• portrait_image: Gere imagens retrato 1024x1536

Todos os comandos de atalho aceitam os mesmos parâmetros que generate_ai_image, exceto size (que é predefinido).

Exemplos de prompts:

• "Um gato vermelho no estilo Picasso"
• "Um pôr do sol sobre montanhas, fotorrealista"
• "Padrões geométricos abstratos em azul e dourado"

Desenvolvimento

# Clone the repository
git clone https://github.com/iplanwebsites/image-mcp.git
cd image-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Start the server
npm start

Requisitos

• Node.js >= 18.0.0
• Chaves de API válidas para OpenAI e/ou Replicate

TODOs

Urgentes

• Corrigir problema do módulo npm: Ele só funciona localmente...

Melhorias

• Guias melhores: Adicionar guias de configuração mais detalhados com etapas de solução de problemas, um botão Adicionar ao cursor, etc

• Usar a biblioteca ai-image diretamente: Substituir chamadas de CLI de subprocesso por importações diretas da biblioteca

• Retornar caminhos de arquivo: Retornar os caminhos dos arquivos de imagem criados na resposta

• Suporte a inferência local: Adicionar suporte para modelos locais como Flux

• Otimização de imagens: Adicionar opções leves de redimensionamento e otimização de imagens

• Ferramenta de legendagem de imagens: Adicionar modelo de legendagem para casos de uso básicos (útil para modelos sem visão)

Licença

MIT