Gemini Imagen 3.0 MCP Server

Gemini Imagen 3.0 MCP 服务

这是一个专业的模型上下文协议（MCP）服务实现，通过 Gemini API 使用 Google 的 Imagen 3.0 模型，生成高质量图像。本项目使用 TypeScript 构建，旨在与 Claude Desktop 及其他兼容 MCP 的宿主无缝集成。

🌟 功能

• 通过 Gemini API 使用 Google 最先进的 Imagen 3.0 模型
• 每次请求最多生成 4 张高质量图像
• 自动管理文件并智能命名
• 生成支持 file:// 协议的 HTML 预览
• 基于 MCP 协议构建，兼容 AI Agent
• 使用 TypeScript 实现，并提供可靠的错误处理

🚀 快速开始

前提条件

• Node.js 18 或更高版本
• Google Gemini API 密钥
• Claude Desktop 或其他兼容 MCP 的宿主

安装

1. 克隆仓库：

git clone https://github.com/yourusername/gemini-imagen-mcp-server.git
cd gemini-imagen-mcp-server

2. 安装依赖项：

npm install

3. 构建 TypeScript 代码：

npm run build

⚙️ 配置

1. 在 claude_desktop_config.json 中添加配置，以设置 Claude Desktop：

{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<path-to-project-directory>",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

2. 替换占位符：
   • <path-to-project-directory>：项目路径
   • your-gemini-api-key：Gemini API 密钥

🛠️ 可用工具

1. generate_images

使用 Google 的 Imagen 3.0 模型生成图像。

参数：

• prompt（必填）：要生成图像的文字描述
• numberOfImages（可选）：图像数量（1-4，默认值：1）

文件管理：

• 图像会自动保存到 G:\image-gen3-google-mcp-server\images
• 文件名格式为：{sanitized-prompt}-{timestamp}-{index}.png
• 时间戳可确保文件名唯一
• 提示词会经过清理，以确保可安全用于文件系统

示例：

Generate an image of a futuristic city at night

2. create_image_html

为生成的图像创建 HTML 预览标签。

参数：

• imagePaths（必填）：图像文件路径数组
• width（可选）：图像宽度（像素，默认值：512）
• height（可选）：图像高度（像素，默认值：512）

返回包含绝对 file:// URL 的 HTML 标签，供本地查看。

示例：

Create HTML tags for the generated images with width=400

🔧 开发

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests (when available)
npm test

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。对于重大变更：

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 发起 Pull Request

📝 错误处理

此服务实现了两种主要错误代码：

• tool_not_found（1）：请求的工具不可用时
• execution_error（2）：图像生成或 HTML 创建失败时

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

✨ 作者

Falah G. Salieh

• 版权所有 © 2025
• GitHub： @yourgithubhandle
• 电子邮件：[email protected]

🙏 致谢

• Google Gemini API 和 Imagen 3.0 模型
• Anthropic 开发的模型上下文协议（MCP）
• Claude Desktop 团队实现 MCP 宿主

📌 标签

#MCP #Gemini #Imagen3 #AI #ImageGeneration #TypeScript #NodeJS #GoogleAI #ClaudeDesktop

---

由 Falah G. Salieh 倾情打造 ❤️