Image Gen3 Google MCP Server

🚀 双子星 Imagen 3.0 MCP 服务器

一款专业的模型上下文协议（MCP）服务器实现，借助 Google 的 Imagen 3.0 模型与双子星 API 结合，可进行高质量图像生成。该服务器使用 TypeScript 构建，专为与 Claude Desktop 及其他 MCP 兼容主机实现无缝集成而设计。

✨ 主要特性

• 强大的图像生成能力：利用 Google 最新的 Imagen 3.0 模型，通过双子星 API，每次请求最多可生成 4 张高质量图像。
• 智能文件管理：具备自动文件管理功能，采用智能命名方式。
• 便捷的预览方式：支持 HTML 预览生成和 file:// 协议访问。
• 广泛的兼容性：基于 MCP 协议，与 AI 代理兼容。
• 稳定的代码实现：使用 TypeScript 实现，拥有强大的错误处理能力。

🚀 快速开始

先决条件

• Node.js 18 或更高版本
• Google 双子星 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 中添加配置：

{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<项目目录路径>",
      "env": {
        "GEMINI_API_KEY": "你的双子星 API 密钥"
      }
    }
  }
}

2. 替换占位符：
   • <项目目录路径>：你的项目路径
   • 你的双子星 API 密钥：你的双子星 API 密钥

🛠️ 可用工具

1. generate_images

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

• 参数：
  • prompt（必需）：图像描述的文本
  • numberOfImages（可选）：要生成的图像数量，默认为 1

2. view_logs

查看服务器日志。

💻 使用示例

基础用法

# 在终端中运行以下命令来生成图像
node generate_images.js --prompt "一只飞翔的鸟" --numberOfImages 3

# 查看日志
node view_logs.js

📚 详细文档

项目结构

• src/：包含核心逻辑和模块。
• build/：存放构建后的文件。

运行时依赖

• Node.js：用于运行服务器。
• npm/yarn：用于管理依赖项。

🤝 贡献指南

欢迎贡献！请参考 CONTRIBUTING.md 了解如何参与开发。

⚠️ 重要提示

• 确保 API 密钥安全，避免泄露。
• 在生产环境中，请根据需要配置相关安全措施。

📋 错误处理

常见错误

1. API 调用失败
   • 检查网络连接和 API 密钥是否正确。
   • 查看日志以获取详细错误信息。
2. 模块未找到
   • 确保所有依赖项已正确安装。
   • 检查文件路径是否正确。

📄 许可证

本项目遵循 MIT 协议。详情请参阅 LICENSE。

💻 作者信息

联系方式

• 邮箱：[你的邮箱地址]
• GitHub：[你的 GitHub 链接]

致谢

感谢所有贡献者和开源社区的支持！

由 Falah G. Salih 热爱打造