jimeng-mcp-volcengine

# 即梦AI MCP服务器 - 火山引擎官方API版 直接调用火山引擎官方API (doubao-seedream-4.0) 的MCP服务器，支持文生图、图生图、多图融合、组图生成等全部功能。 ## ✨ 特色功能 - 🎨 **文生图**：根据文字描述生成高质量图像 - 🖼️ **图生图**：基于参考图片生成新图像 - 🎭 **多图融合**：融合多张参考图的元素（最多10张） - 📚 **组图生成**：一次生成多张主题相关的图片（最多15张） - 🚀 **批量处理**：支持多个prompt批量生成 - 💾 **自动保存**：生成的图片自动下载并保存到本地 - 🌐 **官方直连**：直接调用火山引擎官方API，稳定可靠 ## 🚀 快速开始 ### 1. 克隆仓库 ```bash git clone https://github.com/yourusername/jimeng-mcp-volcengine.git cd jimeng-mcp-volcengine ``` ### 2. 安装依赖 ```bash pip install -r requirements.txt ``` ### 3. 配置环境变量 ```bash # 复制环境变量模板 cp .env.example .env # 编辑.env文件，填入您的API密钥 vi .env # 或者直接设置环境变量 export ARK_API_KEY="your-api-key" export JIMENG_OUTPUT_DIR="./outputs" ``` ### 4. 配置 Claude Desktop 编辑配置文件： - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` 添加以下配置： ```json { "mcpServers": { "jimeng-volc": { "command": "python3", "args": ["/path/to/jimeng_mcp.py"], "env": { "ARK_API_KEY": "your-api-key", "JIMENG_OUTPUT_DIR": "~/Desktop/jimeng_images" } } } } ``` ### 5. 重启 Claude Desktop ## 📚 使用示例 ### 基础用法 ```python # 简单文生图 jimeng("一只可爱的猫咪在花园里玩耍") # 指定尺寸 jimeng("壮丽的山水风景画", size="16:9") # 关闭水印 jimeng("产品图", watermark=False) ``` ### 🌟 高级功能 #### 图生图（参考图生成） ```python # 单张参考图 jimeng("改为卡通风格", image="http://example.com/photo.jpg") # 多张参考图融合 jimeng( prompt="融合这些元素创造新场景", image=["url1.jpg", "url2.jpg", "url3.jpg"] ) ``` #### 📚 组图生成（重点！） 组图生成使用`auto`模式，AI会根据prompt内容自动决定生成数量： ```python # 示例1：生成3张不同时间的图片 jimeng( prompt="生成3张不同时间段的海边风景：日出、正午、日落", sequential="auto", max_images=3 # 设置上限为3张 ) # 示例2：生成5张不同风格 jimeng( prompt="生成5张不同艺术风格的花朵：油画、水彩、素描、国画、卡通", sequential="auto", max_images=5 ) # 示例3：故事叙述 jimeng( prompt="生成4张图讲述小猫的一天：起床、吃饭、玩耍、睡觉", sequential="auto", max_images=4 ) ``` **重要提示：** - 在prompt中明确说明需要的数量（如"生成3张"） - 详细描述每张图的内容 - `max_images`参数设置为期望的数量 #### 批量生成 ```python # 多prompt批量…