Gemini Imagen 3.0 MCP Server

Gemini Image 3.0 MCP服务器

专业的模型上下文协议（MCP）服务器实现，通过Gemini API利用Google的Imagen 3.0模型生成高质量的图像。使用TypeScript构建，旨在与Claude Desktop和其他MCP兼容主机无缝集成。

🌟 特性

• 通过Gemini API利用Google最先进的Imagen 3.0模型
• 每次请求最多生成4张高质量图像
• 具有智能命名的自动文件管理
• 支持文件//协议的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

1. 安装依赖项：

npm install

1. 构建TypeScript代码：

npm run build

⚙️ 配置

1. 通过添加配置Claude Desktop claude_desktop_config.json:

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

1. 替换占位符：

- ：您的项目路径 - your-gemini-api-key：您的Gemini API密钥

🛠️ 可用工具

1.生成图像

使用谷歌的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.创建图片.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

🤝 贡献

欢迎投稿！请随时提交拉取请求。对于重大变更：

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

📝 错误处理

服务器实现了两个主要错误代码：

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

📄 许可证

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

✨ 作者

法拉·萨利赫

• 版权所有©2025
• github：
• 电子邮件： your.email@example.com

🙏 致谢

• 谷歌Gemini API和Image 3.0模型
• Anthropic的模型上下文协议（MCP）
• Claude Desktop团队负责MCP主机的实施

📌 标签

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

______________________________________________________________________

由以下材料制成❤️ 法拉·萨利赫