AI导哈

图像生成服务器

一个专业的模型上下文协议(MCP)服务器实现，通过Gemini API利用Google的Imagen 3.0模型进行高质量图像生成，使用TypeScript构建，设计用于与Claude Desktop和其他MCP兼容主机的无缝集成。

  • by falahgs
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 falahgs/image-gen3-google-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": "<path-to-project-directory>",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}
  1. 替换占位符：
    • <path-to-project-directory>：您的项目路径
    • 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许可证-请参阅 许可证 文件以获取详细信息。

✨ 作者

法拉·萨利赫

🙏 致谢

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

📌 标签

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

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

相关 MCP