Gemini图像生成服务

MCP谷歌Gemini图像生成服务器

Logo generated using Google Gemini via this MCP server

一种模型上下文协议（MCP）服务器，提供Google Gemini图像生成功能，特别支持Imagen 4模型，用于生成具有增强文本渲染和详细图像的高质量图像。

特性

• 图4支持：使用谷歌最新的Imagen 4模型生成高质量图像
• 多种型号：支持Imagen 4的标准和超版本
• 灵活的参数：可配置的宽高比、图像数量和人物生成设置
• 自动文件管理：图像会自动保存到您的桌面
• TypeScript：完全支持TypeScript，具有正确的类型定义
• MCP协议：与MCP兼容客户端无缝集成

安装

1. 克隆此存储库
2. 安装依赖项：
   复制

   npm install
   

3. 构建项目：
   复制

   npm run build
   

配置

API密钥设置

1. 从获取Google API密钥 谷歌云控制台
2. 为您的项目启用Generative AI API
3. 启动MCP服务器
4. 使用 configure-server 在生成图像之前设置API密钥的工具
   • 备注：您的API密钥将自动保存到 ~/.mcp-gemini-image.json 供将来使用

用法

运行服务器

npm start

可用工具

1. generate-image

使用Google Gemini Imagen 4生成图像。

参数：

• prompt （必填）：所需图像的文字描述
• model （可选）：选择 imagen-4.0-generate-preview-06-06 （默认）或 imagen-4.0-ultra-generate-preview-06-06
• aspect_ratio （可选）： square, portrait，或 landscape （默认值： square)
• num_images （可选）：要生成的图像数量（标准1-4，超标准1）（默认值：1）
• person_generation （可选）： dont_allow, allow_adult，或 allow_all （默认值： allow_adult)
• filename （可选）：保存图像的自定义文件名

例子：

{
  "prompt": "A serene mountain landscape with a crystal clear lake reflecting the snow-capped peaks at sunset",
  "model": "imagen-4.0-generate-preview-06-06",
  "aspect_ratio": "landscape",
  "num_images": 2
}

2. configure-server

配置Google API凭据。

参数：

• api_key （必需）：您的Google API密钥
• project_id （可选）：您的Google Cloud项目ID

备注：凭据会自动保存到 ~/.mcp-gemini-image.json 并且将在服务器重启之间持续存在。

例子：

{
  "api_key": "your-google-api-key"
}

3. get-config-status

检查服务器的当前配置状态。

退货：

• 配置状态
• 可用型号
• 图像保存目录

4. list-supported-models

列出所有支持的Google Gemini图像生成模型及其功能。

退货：

• 型号详细信息
• 每个型号的最大图像数量
• 模型特征

模型比较

图4标准(imagen-4.0-generate-preview-06-06)

• 最大图像数：每个请求1-4个
• 特性：高质量、细节丰富的图像，光线充足
• 最适合：通用图像生成，多种变体

图像4 Ultra(imagen-4.0-ultra-generate-preview-06-06)

• 最大图像数：每个请求1个
• 特性：增强的质量和细节，高级版本
• 最适合：高品质单张图片，专业使用

文件管理

图像会自动保存到：

• 目录: ~/Desktop/gemini-images/
• 格式：带时间戳的PNG文件
• 元数据：带有生成参数的JSON文件

错误处理

服务器为以下内容提供全面的错误处理：

• API凭据无效
• 模型参数验证
• 网络连接问题
• 文件系统错误

发展

脚本

• npm run build：构建TypeScript项目
• npm run dev：观看模式用于开发
• npm run clean：清理生成目录

项目结构

src/
├── index.ts            # Main entry point
├── server.ts           # MCP server implementation
├── config-manager.ts   # Configuration management
├── image-generator.ts  # Google Gemini API integration
├── file-manager.ts     # File operations
└── types.ts           # TypeScript definitions

需求

• Node.js 18.0.0或更高版本
• 启用Generative AI API的Google API密钥
• TypeScript 5.0.0或更高版本

许可证

MIT许可证

贡献

1. 分叉存储库
2. 创建功能分支
3. 提交您的更改
4. 推到分支
5. 创建拉取请求

支持

有关问题和疑问，请在GitHub存储库上打开问题。

更新日志

v1.0.0

• 支持Imagen 4的初始版本
• 基本图像生成功能
• 配置管理
• 文件管理系统