JinDaGe - image-gen3-google-mcp-server MCP Details

article

README

🚀 双子星 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 兼容主机

安装

克隆仓库：

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

安装依赖项：

npm install

构建 TypeScript 代码：

npm run build

⚙️ 配置

在 claude_desktop_config.json 中添加配置：

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

替换占位符：
- <项目目录路径>：你的项目路径
- 你的双子星 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 密钥安全，避免泄露。

在生产环境中，请根据需要配置相关安全措施。

📋 错误处理

常见错误

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

📄 许可证

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

💻 作者信息

联系方式

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

致谢

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

由 Falah G. Salih 热爱打造

image-gen3-google-mcp-server