Gemini Imagen 3.0

A professional Model Context Protocol (MCP) server implementation that harnesses Google's Imagen 3.0 model through the Gemini API for high-quality image generation. Built with TypeScript and designed for seamless integration with Claude Desktop and other MCP-compatible hosts.

- Leverage Google's state-of-the-art Imagen 3.0 model via Gemini API
- Generate up to 4 high-quality images per request
- Automatic file management with intelligent naming
- HTML preview generation with file:// protocol support
- Built on MCP protocol for AI agent compatibility
- TypeScript implementation with robust error handling

- Node.js 18 or higher
- Google Gemini API key
- Claude Desktop or another MCP-compatible host

git clone https://github.com/yourusername/gemini-imagen-mcp-server.git cd gemini-imagen-mcp-server

- Configure Claude Desktop by adding toclaude_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" } } } }

- Replace placeholders:

- <path-to-project-directory>: Your project path
- your-gemini-api-key: Your Gemini API key

Generates images using Google's Imagen 3.0 model.

- prompt(required): Text description of the image to generate
- numberOfImages(optional): Number of images (1-4, default: 1)

- Images are automatically saved inG:\image-gen3-google-mcp-server\images
- Filenames follow the pattern:{sanitized-prompt}-{timestamp}-{index}.png
- Timestamps ensure unique filenames
- Prompts are sanitized for safe filesystem usage

Generate an image of a futuristic city at night

Creates HTML preview tags for generated images.

- imagePaths(required): Array of image file paths
- width(optional): Image width in pixels (default: 512)
- height(optional): Image height in pixels (default: 512)

Returns HTML tags with absolute file:// URLs for local viewing.

Create HTML tags for the generated images with width=400

# Install dependencies npm install # Build TypeScript npm run build # Run tests (when available) npm test

Contributions are welcome! Please feel free to submit a Pull Request. For major changes:
- Fork the repository
- Create your feature branch (git checkout -b feature/AmazingFeature)
- Commit your changes (git commit -m 'Add some AmazingFeature')
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request

The server implements two main error codes:

- tool_not_found(1): When the requested tool is not available
- execution_error(2): When image generation or HTML creation fails

MIT License - see theLICENSEfile for details.

- Copyright © 2025
- GitHub:@yourgithubhandle
- Email:your.email@example.com

next-devtools-mcp is a MCP server that provides Next.js development tools and utilities for AI coding assistants like Claude and Cursor.