seedream-mcp

# Seedream 4.0 MCP 工具     基于火山引擎 Seedream 4.0 API 的 MCP（Model Context Protocol）工具集，提供文生图、图生图、多图融合和组图生成等功能。 ## 功能特性 - 🎨 **文生图**：根据文本描述生成高质量图像 - 🖼️ **图生图**：基于参考图像和文本指令生成新图像 - 🎭 **多图融合**：融合多张参考图的特征生成新图像 - 📚 **组图生成**：生成一组内容关联的图像序列 - 💾 **自动保存**：自动下载并保存生成的图片到本地，解决 URL 过期问题 - 📝 **Markdown 支持**：自动生成本地图片的 Markdown 引用格式 - 🔧 **完整的 MCP 协议支持**：符合 MCP 标准，可与支持 MCP 的客户端无缝集成 ## 安装要求 - Python 3.8+ - 火山引擎 Seedream 4.0 API 密钥 ## 安装方法 ### 1. 克隆项目 ```bash git clone <repository-url> cd Seedream_MCP ``` ### 2. 安装依赖 ```bash pip install -e . ``` ### 3. 配置环境变量 创建 `.env` 文件： ```bash # 必需配置 ARK_API_KEY=your_api_key_here # 可选配置 ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3 SEEDREAM_MODEL_ID=doubao-seedream-4-0-250828 SEEDREAM_DEFAULT_SIZE=2K SEEDREAM_DEFAULT_WATERMARK=true SEEDREAM_TIMEOUT=60 SEEDREAM_API_TIMEOUT=60 SEEDREAM_MAX_RETRIES=3 LOG_LEVEL=INFO LOG_FILE=logs/seedream_mcp.log # 自动保存配置 SEEDREAM_AUTO_SAVE_ENABLED=true SEEDREAM_AUTO_SAVE_BASE_DIR=./seedream_images SEEDREAM_AUTO_SAVE_DOWNLOAD_TIMEOUT=30 SEEDREAM_AUTO_SAVE_MAX_RETRIES=3 SEEDREAM_AUTO_SAVE_MAX_FILE_SIZE=52428800 SEEDREAM_AUTO_SAVE_MAX_CONCURRENT=5 SEEDREAM_AUTO_SAVE_DATE_FOLDER=true SEEDREAM_AUTO_SAVE_CLEANUP_DAYS=30 ``` ## 使用方法 ### 作为 MCP 服务器运行 ```bash python -m seedream_mcp.server ``` ### 在代码中使用 ```python import asyncio from seedream_mcp import SeedreamClient, SeedreamConfig async def main(): # 加载配置 config = SeedreamConfig.from_env() # 创建客户端 client = SeedreamClient(config) try: # 文生图（启用自动保存） result = await client.text_to_image( prompt="一只可爱的小猫咪，卡通风格", size="2K", watermark=T…