Imagen3-Service-Facilitator (MCP Adapter)

English Version

利用 Google 最新的 Imagen 3.0 模型的图像生成服务接口，通过 MCP（模型控制协议）进行封装和调用。

示例输出

生成一只正在疾驰的杰克罗素梗犬，采用长焦镜头模拟，光线穿过其皮毛的细节，达到照片级逼真度。

绘制一个具有未来主义科技美学的苹果形象。

前置条件

• 必需具备有效的 Google Gemini API 访问凭证

配置指南——Cherry Studio 环境

1. 从 GitHub Releases 页面获取最新编译好的二进制文件。
2. 将此可执行文件放置于系统路径下的任意安全位置，例如 C:\toolchain\imagen3-mcp.exe。
3. 在 Cherry Studio 界面中进行以下设置：
4. Command 字段: 填入上一步放置的可执行文件完整路径，例如 C:\toolchain\imagen3-mcp.exe。
5. 环境变量 GEMINI_API_KEY: 输入您的授权 API 密钥。
6. [可选] 环境变量 BASE_URL: 配置请求代理地址（如需要规避地域限制），例如 https://proxy.your-service.net/api/provider/google。
7. [可选] 环境变量 SERVER_LISTEN_ADDR: 定义后端服务监听的网络接口地址（默认绑定 127.0.0.1）。
8. [可选] 环境变量 SERVER_PORT: 配置服务监听端口，该端口也将用于生成图片的 URL 引用（默认值为 9981）。
9. [可选] 环境变量 IMAGE_RESOURCE_SERVER_ADDR: 用于构造图片访问链接的基础地址（默认 127.0.0.1）。此项在服务部署于容器或远程服务器时尤其关键。

配置指南——Cursor IDE 环境

{ "mcpServers": { "imagen3_generator": { "command": "C:\toolchain\imagen3-mcp.exe", "env": { "GEMINI_API_KEY": "" // 附加环境变量配置示例: // "BASE_URL": "", // "SERVER_LISTEN_ADDR": "0.0.0.0", // 监听所有可用接口 // "SERVER_PORT": "9981", // "IMAGE_RESOURCE_SERVER_ADDR": "img.myhost.com" // 使用域名作为资源地址 } } } }

知识产权声明

遵循 MIT 协议。

---

Imagen3-Service-Facilitator (English)

An infrastructure component built around Google's state-of-the-art Imagen 3.0 for image synthesis, exposed via the Model Control Protocol (MCP).

Operational Examples

A depiction of a rapidly moving Jack Russell Terrier, utilizing a telephoto lens perspective, emphasizing sunlight interaction with the coat texture, rendered with photographic veracity.

An abstract representation of an apple infused with advanced technological motifs.

Prerequisites

• A valid, authenticated Google Gemini API credential

Deployment Instructions—Cherry Studio Workbench

1. Obtain the most recent compiled binary package from the GitHub Releases repository.
2. Install the binary file in a persistent, accessible location on your machine, such as C:\toolchain\imagen3-mcp.exe.
3. Configure the integration within the Cherry Studio environment:
4. Command Field: Specify the absolute path to the executable, e.g., C:\toolchain\imagen3-mcp.exe.
5. Environment Variable GEMINI_API_KEY: Input your granted API key.
6. [Optional] Environment Variable BASE_URL: Set a network transit point if needed, e.g., https://gateway.external-proxy.net.
7. [Optional] Environment Variable SERVER_LISTEN_ADDR: Dictates the network interface IP the internal web server binds to (default is 127.0.0.1).
8. [Optional] Environment Variable SERVER_PORT: Defines the communication port for the service and the port embedded in generated image URLs (default is 9981).
9. [Optional] Environment Variable IMAGE_RESOURCE_SERVER_ADDR: The host address used when constructing URLs pointing back to the generated media (default 127.0.0.1). This is critical for externally accessible deployments.

Deployment Instructions—Cursor IDE Integration

{ "mcpServers": { "imagen3_generator": { "command": "C:\toolchain\imagen3-mcp.exe", "env": { "GEMINI_API_KEY": "" // Supplementary configuration variables: // "BASE_URL": "", // "SERVER_LISTEN_ADDR": "0.0.0.0", // Bind to all network interfaces // "SERVER_PORT": "9981", // "IMAGE_RESOURCE_SERVER_ADDR": "media.myplatform.io" // Use a public domain for access } } } }

Licensing

MIT License