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 代理兼容性
• 使用强大的错误处理的 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": "<项目目录的路径>",
      "env": {
        "GEMINI_API_KEY": "你的-gemini-api-密钥"
      }
    }
  }
}

2. 替换占位符：
   • <项目目录的路径>：你的项目路径
   • 你的-gemini-api-密钥：你的 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
• 时间戳确保唯一的文件名
• 提示经过清理，以确保安全的文件系统使用

示例：

生成一张夜晚未来城市的图像

2. create_image_html

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

参数：

• imagePaths (必需): 图像文件路径数组
• width (可选): 图像宽度（像素）（默认：512）
• height (可选): 图像高度（像素）（默认：512）

返回带有绝对 file:// URL 的 HTML 标签，用于本地查看。

示例：

为生成的图像创建宽度=400 的 HTML 标签

🔧 开发

# 安装依赖项
npm install

# 构建 TypeScript
npm run build

# 运行测试（如果可用）
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
• 电子邮件: your.email@example.com

🙏 鸣谢

• Google Gemini API 和 Imagen 3.0 模型
• Anthropic 的模型上下文协议 (MCP)
• Claude Desktop 团队的 MCP 主机实现

📌 标签

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

---

用 ❤️ 由 Falah G. Salieh 制作