Gemini Imagen MCP Server

Claude代码的Gemini Imagen MCP服务器

](https://badge.fury.io/js/gemini-imagen-mcp-server)  ](https://nodejs.org/)

🎨 完善的克劳德码MCP服务器 使用谷歌的Gemini Imagen API生成AI驱动的图像。直接在项目中生成图像 imagen/ 编码时使用文件夹！

✨ 为什么选择MCP服务器？

• 🔥 Claude代码优化：专为Claude Code工作流程设计
• 📁 项目集成：直接保存在项目中的图像 imagen/ 文件夹
• 🎯 零设置：只需添加API密钥并开始生成图像
• ⚡ 多种型号：支持Image 3、Image 4和Image 4 Ultra
• 📦 批处理：高效生成多张图像
• 🎛️ 高级控制：纵横比、负面提示、种子等

🚀 快速开始

1.获取API密钥

从获取免费Gemini API密钥 谷歌人工智能工作室

2.安装和配置

无需安装 -与npx一起使用：

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "npx",
      "args": ["-y", "gemini-imagen-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

3.开始生成图像！

Generate an image of "a futuristic robot coding in a modern office"

图像将保存到 imagen/ 当前项目中的文件夹！ 🎯

📁 运作原理

生成图像时，它们会自动以描述性文件名保存：

your-project/
├── imagen/
│   ├── imagen-4-ultra_2024-01-15T10-30-45_futuristic_robot_coding_1.png
│   ├── imagen-4_2024-01-15T10-32-12_sunset_landscape_1.png
│   └── imagen-3_2024-01-15T10-35-01_abstract_art_design_1.png
├── src/
└── README.md

🎨 可用型号

💡 使用示例

基本图像生成

Generate an image of "a cat wearing a space helmet"

高级参数

Generate an image with these settings:
- Prompt: "minimalist website mockup for a coffee shop"
- Model: imagen-4-ultra
- Aspect ratio: 16:9
- Negative prompt: "cluttered, busy, complex"

批量生成

Generate images for these prompts:
1. "logo design for a tech startup"
2. "mobile app interface wireframe"
3. "modern dashboard UI design"

项目设计资产

Create a collection of images:
- "app icon design, minimalist, blue and white"
- "hero banner for landing page, technology theme"
- "user avatar placeholder, professional style"

🎛️ 高级功能

纵横比

• 1:1 -完美的方块（标志、头像）
• 16:9 -宽屏（横幅、标题）
• 9:16 -肖像（移动屏幕）
• 4:3 -标准（演示文稿）
• 3:4 -肖像（海报）

控制参数

• 负面提示：指定要避免的内容
• 种子：获得可重复的结果
• 人员生成：控制人员外观
• 输出格式：JPEG或PNG

批处理

使用共享设置高效生成多个图像：

Generate a batch of logo variations with these prompts:
["minimalist coffee logo", "geometric coffee logo", "vintage coffee logo"]
using imagen-4-ultra with 1:1 aspect ratio

⚙️ 配置选项

命令行参数

# Use different default model
npx gemini-imagen-mcp-server --model imagen-4-ultra

# Enable batch processing
npx gemini-imagen-mcp-server --batch --max-batch-size 8

# Custom output directory
npx gemini-imagen-mcp-server --output-dir assets/images

可用选项

🛠️ 安装方法

选项1:NPX（推荐）

无需安装！只需配置和使用：

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "npx",
      "args": ["-y", "gemini-imagen-mcp-server"],
      "env": {"GEMINI_API_KEY": "your-key"}
    }
  }
}

选项2：全局安装

npm install -g gemini-imagen-mcp-server

然后配置：

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "gemini-imagen-claude-code",
      "env": {"GEMINI_API_KEY": "your-key"}
    }
  }
}

方案3：地方发展

git clone https://github.com/serkanhaslak/gemini-imagen-mcp-server.git
cd gemini-imagen-mcp-server
npm install
npm run build

🧪 开发与测试

构建与测试

# Build the project
npm run build

# Run comprehensive tests
npm run test

# Development with auto-rebuild
npm run watch

# Interactive testing with MCP Inspector
npm run dev

项目结构

src/
├── index.ts          # Main MCP server implementation
build/                # Compiled JavaScript
test_server.js        # Comprehensive test suite
tsconfig.json         # TypeScript configuration

🔧 可用工具

generate_image

通过全参数控制生成单个或多个图像。

batch_generate

使用共享设置高效处理多个提示。

list_models

显示所有可用的Imagen型号及其功能。

health_check

检查服务器状态、API连接和配置。

📚 资源

generation_history

使用完整参数访问最近的图像生成历史记录。

api_documentation

全面的API文档和示例。

🐛 故障排除

常见问题

“找不到GEMINI_API_KEY”

• 确保在MCP配置中设置了API密钥
• 验证密钥是否有效并已启用计费

“未生成图像”

• 检查提示是否违反了内容策略
• 先尝试一个更简单的提示
• 验证是否未超过API配额

“权限被拒绝”

• 确保Claude Code具有对项目目录的写访问权限
• 检查一下 imagen/ 可以创建文件夹

调试模式

运行调试日志：

DEBUG=* npx gemini-imagen-mcp-server

🎯 非常适合Claude代码项目

此MCP服务器是专门为使用Claude Code的开发人员设计的：

• 以项目为中心：图像直接进入您的项目
• 开发者友好：带有时间戳的描述性文件名
• 工作流集成：编码时生成资产
• 版本控制就绪：专用文件夹中的图像
• 批量操作：高效生成多种资产

🔒 安全与最佳实践

• ✅ 通过环境变量安全处理API密钥
• ✅ 使用Zod模式进行输入验证
• ✅ 全面的错误处理
• ✅ 限速和定额管理
• ✅ 未记录或存储敏感数据

📈 用例

网站开发

• 英雄形象和横幅
• UI/UX模型和线框
• 徽标和品牌资产
• 占位符图像

应用开发

• 应用程序图标和启动画面
• 用户界面元素
• 营销资产
• 文档图像

内容创建

• 博客文章插图
• 社交媒体图形
• 演示视觉效果
• 产品模型

🤝 贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 进行更改并添加测试
4. 运行测试： npm test
5. 承诺： git commit -m 'Add amazing feature'
6. 推： git push origin feature/amazing-feature
7. 打开拉取请求

📊 API限制和定价

• 免费等级：充足的月度配额
• 速率限制：自动处理
• 批处理：针对效率进行了优化
• 成本控制：通过健康检查监控使用情况

📜 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🌟 为什么选择此MCP服务器？

• 🎯 订做的：专门用于Claude Code工作流
• ⚡ 零配置：只需API密钥即可开箱即用
• 📁 智能组织：组织在项目文件夹中的图像
• 🔄 积极发展：定期更新和改进
• 📖 优秀的文档：综合指南和示例
• 🛠️ 开发者友好：由开发者构建，面向开发者

______________________________________________________________________

准备好用人工智能生成的图像来增强您的Claude Code项目了吗？

立即安装并开始创建！ 🚀

# Just add to your MCP config and go!
npx -y gemini-imagen-mcp-server --help