STARWARCLOUD STARWAR.AI
返回市场
双子图像处理MCP服务器

双子图像处理MCP服务器

作者：serkanhaslak8 星标更新：2025-07-03
安装使用来源：spider==github.com

项目介绍

Gemini Imagen MCP Server for Claude Code

npm 版本 许可证: MIT Node.js

🎨 专为 Claude Code 设计的完美 MCP 服务器，用于通过 Google 的 Gemini Imagen API 进行人工智能图像生成。在编码时直接在项目中的 imagen/ 文件夹中生成图像！

✨ 为什么选择这个 MCP 服务器？

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

🚀 快速开始

1. 获取您的 API 密钥

从 Google AI Studio 获取免费的 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. 开始生成图像！

生成一张“未来机器人在现代办公室编程”的图像

图像将被保存到当前项目的 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

🎨 可用模型

模型质量速度最佳用途
imagen-4-ultra🌟🌟🌟🌟🌟⚡⚡⚡高品质、详细图像
imagen-4🌟🌟🌟🌟⚡⚡⚡⚡良好质量、更快生成
imagen-3🌟🌟🌟⚡⚡⚡⚡⚡较好质量、最快生成

💡 使用示例

基础图像生成

生成一张“一只猫戴着太空头盔”的图像

高级参数

使用这些设置生成图像：
- 提示：“极简风格的咖啡店网站草图”
- 模型：imagen-4-ultra
- 纵横比：16:9
- 负面提示：“杂乱、忙碌、复杂”

批量生成

为以下提示生成图像：
1. “科技初创公司的标志设计”
2. “移动应用界面线框图”
3. “现代仪表盘UI设计”

项目设计资产

创建一组图像：
- “极简风格的应用图标设计，蓝色和白色”
- “着陆页的英雄横幅，科技主题”
- “专业风格的用户头像占位符”

🎛️ 高级功能

纵横比

  • 1:1 - 完美正方形（如标志、头像）
  • 16:9 - 宽屏（如横幅、标题）
  • 9:16 - 竖屏（如手机屏幕）
  • 4:3 - 标准（如演示文稿）
  • 3:4 - 竖屏（如海报）

控制参数

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

批量处理

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

使用这些提示批量生成标志变体：
["极简风格的咖啡标志", "几何风格的咖啡标志", "复古风格的咖啡标志"]
使用 imagen-4-ultra 模型，纵横比为 1:1

⚙️ 配置选项

命令行参数

# 使用不同的默认模型
npx gemini-imagen-mcp-server --model imagen-4-ultra

# 启用批量处理
npx gemini-imagen-mcp-server --batch --max-batch-size 8

# 自定义输出目录
npx gemini-imagen-mcp-server --output-dir assets/images

可用选项

选项描述默认值
--model默认模型（imagen-3, imagen-4, imagen-4-ultra）imagen-4-ultra
--batch启用批量处理禁用
--max-batch-size最大批次大小（1-8）4
--output-dir输出目录imagen

🛠️ 安装方法

方法 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

🧪 开发与测试

构建与测试

# 构建项目
npm run build

# 运行全面测试
npm run test

# 开发模式自动重建
npm run watch

# 使用 MCP Inspector 进行交互式测试
npm run dev

项目结构

src/
├── index.ts          # 主 MCP 服务器实现
build/                # 编译后的 JavaScript
test_server.js        # 全面测试套件
tsconfig.json         # TypeScript 配置

🔧 可用工具

generate_image

生成单个或多个图像，具有完整的参数控制。

batch_generate

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

list_models

显示所有可用的 Imagen 模型及其能力。

health_check

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

📚 资源

generation_history

访问带有完整参数的最近图像生成历史。

api_documentation

包含示例的全面 API 文档。

🐛 故障排除

常见问题

“未找到 GEMINI_API_KEY”

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

“没有生成图像”

  • 检查提示是否违反内容策略
  • 尝试先使用更简单的提示
  • 验证 API 额度是否未超出

“权限被拒绝”

  • 确保 Claude Code 对项目目录有写入权限
  • 检查 imagen/ 文件夹是否可以创建

调试模式

使用调试日志运行：

DEBUG=* npx gemini-imagen-mcp-server

🎯 适用于 Claude Code 项目

此 MCP 服务器专门针对使用 Claude Code 的开发者：

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

🔒 安全与最佳实践

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

📈 使用案例

网站开发

  • 英雄图像和横幅
  • UI/UX 草图和线框图
  • 标志和品牌资产
  • 占位符图像

应用开发

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

内容创作

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

🤝 贡献

  1. 分叉仓库
  2. 创建功能分支：git checkout -b feature/amazing-feature
  3. 修改并添加测试
  4. 运行测试：npm test
  5. 提交：git commit -m '添加惊人的功能'
  6. 推送：git push origin feature/amazing-feature
  7. 打开拉取请求

📊 API 限制与定价

  • 免费层级：每月慷慨的配额
  • 速率限制：自动处理
  • 批量处理：优化效率
  • 成本控制：使用健康检查监控使用情况

📜 许可证

MIT 许可证 - 详情见 LICENSE 文件。

🌟 为什么选择这个 MCP 服务器？

  • 🎯 目标明确：专门为 Claude Code 工作流程设计
  • ⚡ 零配置：只需 API 密钥即可立即使用
  • 📁 智能组织：图像按项目文件夹组织
  • 🔄 积极开发：定期更新和改进
  • 📖 优秀文档：全面指南和示例
  • 🛠️ 开发者友好：由开发者为开发者打造

准备好用 AI 生成的图像增强您的 Claude Code 项目了吗？

现在安装并开始创建！🚀

# 只需添加到您的 MCP 配置并开始！
npx -y gemini-imagen-mcp-server --help