Imagen3 MCP

1# Imagen3-MCP
2 
3[English Version](#imagen3-mcp-english)
4 
5基于 Google 的 Imagen 3.0 的图像生成工具，通过 MCP（Model Control Protocol）提供服务。
6 
7## 效果
8 
9画一只奔跑的杰克罗素犬，长焦镜头，阳光透过狗狗的毛发，照片级画质
10 
11![奔跑的杰克罗素犬](./docs/Snipaste_2025-04-26_15-18-15.png)
12 
13画一个科技感十足的苹果
14 
15![科技感十足的苹果](./docs/Snipaste_2025-04-26_15-18-02.png)
16 
17## 安装要求
18 
19- 有效的 [Google Gemini API 密钥](https://aistudio.google.com/apikey)
20 
21## 安装步骤——Cherry Studio
22 
231. 从 [GitHub Releases](https://github.com/hamflx/imagen3-mcp/releases) 下载最新版本的可执行文件
242. 将下载的可执行文件放置在系统中的任意位置，例如 `C:\bin\imagen3-mcp.exe`
253. 在 Cherry Studio 中配置：
26   - Command 字段填写可执行文件路径，例如 `C:\bin\imagen3-mcp.exe`
27   - 环境变量 `GEMINI_API_KEY` 中填写你的 Gemini API 密钥
28   - [可选] 环境变量 `BASE_URL` 中填写代理地址，例如 `https://lingxi-proxy.hamflx.dev/api/provider/google`（这个地址可以解决 GFW 的问题，但是解决不了 Google 对 IP 的限制问题，因此还是得挂梯子）。
29   - [可选] 环境变量 `SERVER_LISTEN_ADDR`：设置服务器监听的 IP 地址（默认为 `127.0.0.1`）。
30   - [可选] 环境变量 `SERVER_PORT`：设置服务器监听的端口和图片 URL 使用的端口（默认为 `9981`）。
31   - [可选] 环境变量 `IMAGE_RESOURCE_SERVER_ADDR`：设置图片 URL 中使用的服务器地址（默认为 `127.0.0.1`）。这在服务器运行在容器或远程机器上时很有用。
32 
33![配置](./docs/config.png)
34 
35## 安装步骤——Cursor
36 
37```json
38{
39  "mcpServers": {
40    "imagen3": {
41      "command": "C:\\bin\\imagen3-mcp.exe",
42      "env": {
43        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
44        // Optional environment variables:
45        // "BASE_URL": "<PROXY_URL>",
46        // "SERVER_LISTEN_ADDR": "0.0.0.0", // Example: Listen on all interfaces
47        // "SERVER_PORT": "9981",
48        // "IMAGE_RESOURCE_SERVER_ADDR": "your.domain.com" // Example: Use a domain name for image URLs
49      }
50    }
51  }
52}
53```
54 
55## 许可证
56 
57MIT
58 
59---
60 
61# Imagen3-MCP (English)
62 
63An image generation tool based on Google's Imagen 3.0, providing services through MCP (Model Control Protocol).
64 
65## Examples
66 
67A running Jack Russell Terrier, telephoto lens, sunlight filtering through the dog's fur, photorealistic quality
68 
69![Running Jack Russell Terrier](./docs/Snipaste_2025-04-26_15-18-15.png)
70 
71A high-tech apple
72 
73![High-tech apple](./docs/Snipaste_2025-04-26_15-18-02.png)
74 
75## Requirements
76 
77- Valid [Google Gemini API key](https://aistudio.google.com/apikey)
78 
79## Installation Steps—Cherry Studio
80 
811. Download the latest executable from [GitHub Releases](https://github.com/hamflx/imagen3-mcp/releases)
822. Place the downloaded executable anywhere in your system, e.g., `C:\bin\imagen3-mcp.exe`
833. Configure in Cherry Studio:
84   - Fill in the Command field with the executable path, e.g., `C:\bin\imagen3-mcp.exe`
85   - Enter your Gemini API key in the `GEMINI_API_KEY` environment variable
86   - [Optional] Enter a proxy URL in the `BASE_URL` environment variable, e.g., `https://your-proxy.com`.
87   - [Optional] Set the `SERVER_LISTEN_ADDR` environment variable: The IP address the server listens on (defaults to `127.0.0.1`).
88   - [Optional] Set the `SERVER_PORT` environment variable: The port the server listens on and uses for image URLs (defaults to `9981`).
89   - [Optional] Set the `IMAGE_RESOURCE_SERVER_ADDR` environment variable: The server address used in the image URLs (defaults to `127.0.0.1`). Useful if the server runs in a container or remote machine.
90 
91![Configuration](./docs/config.png)
92 
93## Installation Steps—Cursor
94 
95```json
96{
97  "mcpServers": {
98    "imagen3": {
99      "command": "C:\\bin\\imagen3-mcp.exe",
100      "env": {
101        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
102        // Optional environment variables:
103        // "BASE_URL": "<PROXY_URL>",
104        // "SERVER_LISTEN_ADDR": "0.0.0.0", // Example: Listen on all interfaces
105        // "SERVER_PORT": "9981",
106        // "IMAGE_RESOURCE_SERVER_ADDR": "your.domain.com" // Example: Use a domain name for image URLs
107      }
108    }
109  }
110}
111```
112 
113## License
114 
115MIT
116