OpenAI GPT Image

Gere e edite imagens usando as APIs GPT-4o e DALL-E da OpenAI com controle avançado de prompts.

GitHub
113
Experimente este MCPPatrocinado

Documentação

openai-gpt-image-mcp

MCP SDK OpenAI SDK License GitHub stars Build Status

Um servidor de ferramentas Model Context Protocol (MCP) para as APIs de geração e edição de imagens GPT-4o/gpt-image-1 da OpenAI.

  • Gere imagens a partir de prompts de texto usando os modelos mais recentes da OpenAI.
  • Edite imagens (inpainting, outpainting, compositing) com controle avançado de prompt.
  • Suporta: Claude Desktop, Cursor, VSCode, Windsurf e qualquer cliente compatível com MCP.

✨ Recursos

  • create-image: Gere imagens a partir de um prompt, com opções avançadas (tamanho, qualidade, fundo, etc).
  • edit-image: Edite ou estenda imagens usando um prompt e máscara opcional, suportando tanto caminhos de arquivo quanto entrada base64.
  • Saída de arquivo: Salve imagens geradas diretamente no disco ou receba como base64.

🚀 Instalação

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git
cd openai-gpt-image-mcp
yarn install
yarn build

🔑 Configuração

Adicione à configuração do Claude Desktop ou VSCode (incluindo Cursor/Windsurf):

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

Também suporta implantações Azure:

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { 
        "AZURE_OPENAI_API_KEY": "sk-...",
        "AZURE_OPENAI_ENDPOINT": "my.endpoint.com",
        "OPENAI_API_VERSION": "2024-12-01-preview"
      }
    }
  }
}

Também suporta fornecer arquivos de ambiente:

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js", "--env-file", "./deployment/.env"]
    }
  }
}

⚡ Avançado

  • Para create-image, defina n para gerar até 10 imagens de uma vez.
  • Para edit-image, forneça uma imagem de máscara (caminho de arquivo ou base64) para controlar onde as edições são aplicadas.
  • Forneça um arquivo de ambiente com --env-file path/to/file/.env
  • Veja src/index.ts para todas as opções.

🧑‍💻 Desenvolvimento

  • Fonte TypeScript: src/index.ts
  • Compilar: yarn build
  • Executar: node dist/index.js

📝 Licença

MIT

🩺 Solução de Problemas

  • Certifique-se de que seu OPENAI_API_KEY é válido e tem acesso à API de imagens.
  • Você deve ter uma organização OpenAI verificada. Após a verificação, pode levar de 15 a 20 minutos para o acesso à API de imagens ser ativado.
  • Os caminhos de arquivo devem ser absolutos.
    • Unix/macOS/Linux: Começando com / (por exemplo, /path/to/image.png)
    • Windows: Letra da unidade seguida por : (por exemplo, C:/path/to/image.png ou C:\path\to\image.png)
  • Para saída de arquivo, garanta que o diretório seja gravável.
  • Se você vir erros sobre tipos de arquivo, verifique as extensões e formatos dos seus arquivos de imagem.

⚠️ Limitações e Manipulação de Arquivos Grandes

  • Limite de Payload de 1MB: Clientes MCP (incluindo Claude Desktop) têm um limite rígido de 1MB para respostas de ferramentas. Imagens grandes (especialmente de alta resolução ou múltiplas imagens) podem facilmente exceder esse limite se retornadas como base64.
  • Alternância Automática para Saída de Arquivo: Se o tamanho total da imagem exceder 1MB, a ferramenta salvará automaticamente as imagens no disco e retornará o(s) caminho(s) do arquivo em vez de base64. Isso garante compatibilidade e evita erros como result exceeds maximum length of 1048576.
  • Local Padrão de Arquivo: Se você não especificar um caminho file_output, as imagens serão salvas em /tmp (ou no diretório definido pela variável de ambiente MCP_HF_WORK_DIR) com um nome de arquivo único.
  • Variável de Ambiente: MCP_HF_WORK_DIR: Defina isso para controlar onde imagens grandes e saídas de arquivo são salvas. Exemplo: export MCP_HF_WORK_DIR=/your/desired/dir
  • Melhor Prática: Para imagens grandes ou de produção, sempre use saída de arquivo e garanta que seu cliente esteja configurado para lidar com caminhos de arquivo.

📚 Referências

🙏 Créditos