🚀 双子星 Imagen 3.0 MCP 服务器

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

🚀 快速开始

先决条件

• 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

✨ 主要特性

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

📦 安装指南

配置

1. 在 claude_desktop_config.json 中添加配置：

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

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

💻 使用示例

基础用法

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

# 查看日志
node view_logs.js

📚 详细文档

可用工具

1. generate_images

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

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

2. view_logs

查看服务器日志。

开发信息

项目结构

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

运行时依赖

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

🔧 技术细节

错误处理

常见错误

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

📄 许可证

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

💻 作者信息

联系方式

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

致谢

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

⚠️ 重要提示

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

由 Falah G. Salih 热爱打造