MCP.so
登录

Gemini Image Generator MCP Server

@qhdrl12

基本信息

分类

AI 与智能体

许可证

MIT

传输方式

stdio

作者

qhdrl12

关于 Gemini Image Generator MCP Server

MCP server for AI image generation and editing using Google's Gemini Flash models. Create images from text prompts with intelligent filename generation and strict text exclusion. Supports text-to-image generation with future expansion to image editing capabilities.

Gemini Image Generator MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-gemini-image-generator": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@qhdrl12/mcp-server-gemini-image-gen",
        "--client",
        "claude"
      ]
    }
  }
}

Gemini Image Generator MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Gemini Image Generator MCP Server?

This MCP server enables AI assistants to generate high-quality images from text prompts and transform existing images using Google's Gemini model via the MCP protocol. It handles prompt engineering, text-to-image conversion, intelligent filename generation, and local image storage. Aimed at users of MCP-compatible clients such as Claude Desktop, Cursor, or other hosts.

How to use Gemini Image Generator MCP Server?

Install via Smithery (npx -y @smithery/cli install @qhdrl12/mcp-server-gemini-image-gen --client claude), or manually clone the repo, create a Python 3.11+ virtual environment, and install dependencies. Configure a Gemini API key (via Google AI Studio) and an optional image output path. Add the server to your MCP client’s configuration (e.g., claude_desktop_config.json) with the command, args, and env keys. Invoke the three available MCP tools: generate_image_from_text, transform_image_from_encoded, or transform_image_from_file.

Key features of Gemini Image Generator MCP Server

  • Text-to-image generation using Gemini 2.0 Flash
  • Image-to-image transformation based on text prompts
  • Support for both file-based and base64-encoded images
  • Automatic intelligent filename generation from prompts
  • Automatic translation of non-English prompts
  • Local image storage with configurable output path

Use cases of Gemini Image Generator MCP Server

  • Generate an image from a natural-language description (e.g., "a sunset over mountains")
  • Transform an existing image by adding or modifying elements (e.g., "add snow to this landscape")
  • Edit a photo by providing a base64-encoded image and a transformation prompt
  • Use the server as a creative assistant for generating illustrations, concept art, or visual ideas

常见问题

1

What does this server do vs. other image generation servers?

It provides text-to-image and image-to-image transformation specifically via Google’s Gemini Flash model, with dual return (image bytes and saved file path). It also offers automatic non-English prompt translation and strict text exclusion from generated images.

2

What runtime dependencies are required?

Python 3.11 or higher, a Google AI API key (Gemini), and an MCP-compatible host application (e.g., Claude Desktop, Cursor).

3

Where are generated images stored?

Images are saved to a local directory specified by the `OUTPUT_IMAGE_PATH` environment variable. The server also returns raw image data (bytes) for direct use.

4

Are there known limitations or issues?

When used with Claude Desktop Host, `transform_image_from_encoded` may perform slowly due to large base64 data transfer, and path resolution problems can occur with returned file paths. Using alternative MCP clients or the `transform_image_from_file` method is recommended.

5

How does authentication work?

Authentication requires a Google AI API key, set via the `GEMINI_API_KEY` environment variable in the MCP client configuration or a `.env` file. The API key provides a certain free quota per month.

评论

AI 与智能体 分类下的更多 MCP 服务器