🚀 双子星 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 热爱打造