Seedream MCP

Seedream 4.0 MCP 工具 (增强版)

   

基于火山引擎 Seedream 4.0 API 的 MCP（Model Context Protocol）工具集，提供文生图、图生图、多图融合和组图生成等功能。

**致谢**: 本项目基于 [tengmmvp/Seedream_MCP](https://github.com/tengmmvp/Seedream_MCP) 进行增强开发，感谢原作者的贡献！

**增强功能**:

• ✨ 七牛云自动上传和公网访问
• 🎨 提示词模板系统 (8个预设模板)
• 📸 Raycast AI Markdown 图片渲染支持
• 💾 优化的图片保存和管理

功能特性

• 🎨 文生图：根据文本描述生成高质量图像
• 🖼️ 图生图：基于参考图像和文本指令生成新图像
• 🎭 多图融合：融合多张参考图的特征生成新图像
• 📚 组图生成：生成一组内容关联的图像序列
• 💾 自动保存：自动下载并保存生成的图片到本地，解决 URL 过期问题
• ☁️ 七牛云上传：可选的七牛云存储集成，自动上传图片并生成公网可访问的 URL
• 📝 Markdown 支持：自动生成图片的 Markdown 引用格式（支持七牛云 URL 和本地路径）
• 🔧 完整的 MCP 协议支持：符合 MCP 标准，可与支持 MCP 的客户端无缝集成
• 🖼️ 直接图片显示：支持 MCP ImageContent 类型，可在客户端中直接预览图片

安装要求

• Python 3.8+
• 火山引擎 Seedream 4.0 API 密钥

安装方法

1. 克隆项目

git clone 
cd Seedream_MCP

2. 安装依赖

pip install -e .

3. 配置环境变量

创建 `.env` 文件：

# 必需配置
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=false
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

# 七牛云配置（可选，用于上传图片到七牛云存储）
QINIU_ACCESS_KEY=your_access_key
QINIU_SECRET_KEY=your_secret_key
QINIU_BUCKET_NAME=your_bucket_name
QINIU_DOMAIN=https://your-domain.com

**注意**: 配置七牛云后,生成的图片会自动上传到七牛云,并在返回结果中提供公网可