# Seedream_MCP
## 基本信息
- Slug: `joeseesun-seedream_mcp`
- Source: modelscope
- Publisher: @joeseesun/Seedream_MCP
- Categories: image-and-video-processing / multimedia-processing / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@joeseesun/Seedream_MCP
## 简介
暂无描述。
## 安装提示

```bash
git clone <repository-url> cd Seedream_MCP
```

## MCP Server 详情

# Seedream 4.0 MCP 工具 (增强版)

![Python](https://img.shields.io/badge/python-3.8+-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![MCP](https://img.shields.io/badge/MCP-compatible-orange.svg)
![Status](https://img.shields.io/badge/status-active-brightgreen.svg)

基于火山引擎 Seedream 4.0 API 的 MCPModel 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. 克隆项目

```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=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
```

**注意**: 配置七牛云后,生成的图片会自动上传到七牛云,并在返回结果中提供公网可访问的 Markdown 图片链接详见 [七牛云集成文档](docs/QINIU_UPLOAD.md)

### 4. 配置 MCP 客户端

在你的 MCP 客户端配置文件中添加以下配置:

**Raycast AI / Claude Desktop / Cline 等:**

```json
{
  "mcpServers": {
    "seedream": {
      "command": "python",
      "args": [
        "/你的路径/Seedream_MCP/main.py"
      ],
      "env": {
        "ARK_BASE_URL": "https://ark.cn-beijing.volces.com/api/v3"
      }
    }
  }
}
```

**配置文件位置:**
- **Raycast AI**: `~/Library/Application Support/com.raycast.macos/mcp.json`
- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Cline (VSCode)**: `.vscode/settings.json` 或用户设置

**重要提示:**
- 将 `/你的路径/Seedream_MCP/main.py` 替换为你的实际项目路径
- 确保 Python 环境已安装所有依赖
- 配置完成后重启 MCP 客户端

## 快速开始

### 在 MCP 客户端中使用 (推荐)

配置好 MCP 客户端后,你可以直接用自然语言对话生成图片:

#### 示例 1: 基础文生图

**你说:**
```
帮我生成一张图片一只可爱的小恐龙友好的表情卡通风格
```

**AI 回复:**

![示例图片1](https://newimg.t5t6.com/seedream/20251118_102310_a_cute_little_dinosaur_friendly_expression_cartoon_20251118_102310.jpeg)

 图片生成成功
- 提示词: 一只可爱的小恐龙友好的表情卡通风格
- 尺寸: 2K
- 七牛云链接: https://newimg.t5t6.com/seedream/...
- 本地保存: `seedream_images/2025-11-18/text_to_image/...`

---

#### 示例 2: 使用提示词模板

**你说:**
```
潮流派对关键词可口可乐
```

**AI 回复:**

![示例图片2](https://newimg.t5t6.com/seedream/20251118_114216_中文可口可乐潮流派对风格艺术字体运营活动风格主题字体字体大小变化明显错落有致排版部分笔画延长字体笔画_20251118_114216.jpeg)

 图片生成成功
- 提示词: 中文"可口可乐",潮流派对风格艺术字体...
- 尺寸: 2K (默认 16:9)
- 七牛云链接: https://newimg.t5t6.com/seedream/...

---

#### 示例 3: 公众号封面

**你说:**
```
公众号封面主题AI 技术革新
```

**AI 回复:**

 图片生成成功
- 提示词: 中文"AI 技术革新",公众号封面风格...
- 尺寸: 2K (自动使用 21:9 比例)
- 七牛云链接: https://newimg.t5t6.com/seedream/...

---

### 可用的提示词模板

直接说出模板名称 + 关键词即可:

| 模板名称 | 使用方式 | 适用场景 |
|---------|---------|---------|
|  **潮流派对** | "潮流派对关键词XXX" | 运营活动艺术字体 |
|  **公众号封面** | "公众号封面主题XXX" | 公众号配图 (21:9) |
|  **国潮风格** | "国潮风格主题XXX" | 中国风设计 |
|  **小清新** | "小清新主题XXX" | 文艺清新风格 |
|  **赛博朋克** | "赛博朋克主题XXX" | 科技未来风格 |
|  **新年喜庆** | "新年喜庆主题XXX" | 节日庆典 |
|  **商务简约** | "商务简约主题XXX" | 商务场景 |
|  **水彩插画** | "水彩插画主题XXX" | 手绘插画风格 |

---

### 作为 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=False,
            auto_save=True,
            custom_name="cute_cat"
        )
        print(f"生成的图像URL: {result['image_url']}")
        print(f"本地保存路径: {result['local_path']}")
        print(f"Markdown引用: {result['markdown']}")

        # 图生图
        result = await client.image_to_image(
            prompt="将这张图片转换为油画风格",
            image="path/to/image.jpg",
            size="2K",
            auto_save=True
        )
        print(f"转换后的图像URL: {result['image_url']}")
        print(f"本地保存路径: {result['local_path']}")

    finally:
        await client.close()

if __name__ == "__main__":
    asyncio.run(main())
```

## 功能特性详解

###  提示词模板系统

内置 8 个专业提示词模板,只需说出模板名称 + 关键词即可生成对应风格的图片:

- **潮流派对**: 运营活动风格艺术字体
- **公众号封面**: 自动使用 21:9 比例,适合公众号配图
- **国潮风格**: 中国传统元素与现代设计结合
- **小清新**: 文艺清新风格
- **赛博朋克**: 科技未来风格
- **新年喜庆**: 节日庆典风格
- **商务简约**: 专业商务场景
- **水彩插画**: 手绘插画风格

###  七牛云自动上传

配置七牛云后,生成的图片会自动上传到七牛云存储:

-  生成公网可访问的永久链接
-  自动生成 Markdown 图片格式
-  支持 Raycast AI 直接渲染图片
-  本地和云端双重保存

###  智能图片管理

- **自动保存**: 图片自动下载到本地,避免 URL 过期
- **按日期分类**: 自动按年/月创建文件夹
- **自动清理**: 可配置自动清理过期图片
- **并发下载**: 支持多图并发下载,提高效率

## 工具说明

### 1. seedream_text_to_image

根据文本描述生成图像

**参数**

- `prompt` (必需): 文本描述建议不超过 300 汉字或 600 英文单词
- `size` (可选): 图像尺寸可选值1K2K4K默认 2K
- `watermark` (可选): 是否添加水印默认 false
- `response_format` (可选): 响应格式可选值imageurlb64_json默认 image
- `auto_save` (可选): 是否自动保存图片到本地默认使用全局配置
- `save_path` (可选): 自定义保存路径不指定则使用默认路径
- `custom_name` (可选): 自定义文件名前缀

**自然语言示例**

```
帮我生成一张图片一只可爱的小猫咪卡通风格
```

或使用提示词模板:

```
潮流派对关键词可口可乐
```

### 2. seedream_image_to_image

基于参考图像和文本指令生成新图像

**参数**

- `prompt` (必需): 图像编辑指令
- `image` (必需): 参考图像 UR…