Gemini Imagen 3.0

Gere imagens de alta qualidade usando o modelo Imagen 3.0 do Google por meio da API Gemini.

GitHub
4
Experimente este MCPPatrocinado

Documentação

Servidor MCP Gemini Imagen 3.0

License Node TypeScript

Uma implementação profissional de servidor Model Context Protocol (MCP) que utiliza o modelo Imagen 3.0 do Google através da API Gemini para geração de imagens de alta qualidade. Construído com TypeScript e projetado para integração perfeita com Claude Desktop e outros hosts compatíveis com MCP.

🌟 Recursos

  • Aproveite o modelo Imagen 3.0 de última geração do Google via API Gemini
  • Gere até 4 imagens de alta qualidade por solicitação
  • Gerenciamento automático de arquivos com nomenclatura inteligente
  • Geração de pré-visualização HTML com suporte ao protocolo file://
  • Construído no protocolo MCP para compatibilidade com agentes de IA
  • Implementação em TypeScript com tratamento robusto de erros

🚀 Início Rápido

Pré-requisitos

  • Node.js 18 ou superior
  • Chave da API Google Gemini
  • Claude Desktop ou outro host compatível com MCP

Instalação

  1. Clone o repositório:
git clone https://github.com/yourusername/gemini-imagen-mcp-server.git
cd gemini-imagen-mcp-server
  1. Instale as dependências:
npm install
  1. Compile o código TypeScript:
npm run build

⚙️ Configuração

  1. Configure o Claude Desktop adicionando ao claude_desktop_config.json:
{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<path-to-project-directory>",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}
  1. Substitua os espaços reservados:
    • <path-to-project-directory>: O caminho do seu projeto
    • your-gemini-api-key: Sua chave da API Gemini

🛠️ Ferramentas Disponíveis

1. generate_images

Gera imagens usando o modelo Imagen 3.0 do Google.

Parâmetros:

  • prompt (obrigatório): Descrição textual da imagem a ser gerada
  • numberOfImages (opcional): Número de imagens (1-4, padrão: 1)

Gerenciamento de Arquivos:

  • As imagens são salvas automaticamente em G:\image-gen3-google-mcp-server\images
  • Os nomes de arquivo seguem o padrão: {sanitized-prompt}-{timestamp}-{index}.png
  • Carimbos de data/hora garantem nomes de arquivo únicos
  • Os prompts são sanitizados para uso seguro no sistema de arquivos

Exemplo:

Generate an image of a futuristic city at night

2. create_image_html

Cria tags HTML de pré-visualização para imagens geradas.

Parâmetros:

  • imagePaths (obrigatório): Matriz de caminhos de arquivos de imagem
  • width (opcional): Largura da imagem em pixels (padrão: 512)
  • height (opcional): Altura da imagem em pixels (padrão: 512)

Retorna tags HTML com URLs absolutas file:// para visualização local.

Exemplo:

Create HTML tags for the generated images with width=400

🔧 Desenvolvimento

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests (when available)
npm test

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas:

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/AmazingFeature)
  3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
  4. Envie para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📝 Tratamento de Erros

O servidor implementa dois códigos de erro principais:

  • tool_not_found (1): Quando a ferramenta solicitada não está disponível
  • execution_error (2): Quando a geração de imagens ou criação de HTML falha

📄 Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

✨ Autor

Falah G. Salieh

🙏 Agradecimentos

  • API Google Gemini e modelo Imagen 3.0
  • Model Context Protocol (MCP) da Anthropic
  • Equipe do Claude Desktop pela implementação do host MCP

📌 Tags

#MCP #Gemini #Imagen3 #AI #ImageGeneration #TypeScript #NodeJS #GoogleAI #ClaudeDesktop

Feito com ❤️ por Falah G. Salieh