SeedreamMCP

👁 PyPI version
👁 PyPI downloads
👁 Python 3.10+
👁 License: MIT
👁 MCP

Сервер Model Context Protocol (MCP) для генерации и редактирования изображений с помощью ИИ ByteDance Seedream через AceDataCloud API.

Создавайте и редактируйте изображения с помощью ИИ прямо из Claude, VS Code или любого клиента, совместимого с MCP.

Возможности

Генерация текста в изображение — создание высококачественных изображений по текстовым запросам (на китайском и английском языках)
Редактирование изображений — изменение существующих изображений с помощью ИИ (перенос стиля, изменение фона, виртуальная примерка)
Несколько моделей — Seedream v5.0 (флагман), v4.5, v4.0, v3.0 T2I, SeedEdit v3.0 I2I
Разрешение — 1K, 2K, 3K, 4K, адаптивное и пользовательские размеры
Контроль сидов (Seed) — воспроизводимые результаты с параметром сида (модели v3)
Последовательная генерация — создание связанных изображений в последовательности (v4.5/v4.0)
Потоковая передача — прогрессивная доставка изображений (v4.5/v4.0)
Отслеживание задач — мониторинг прогресса генерации и получение результатов

Related MCP server: Seedream 4.0 MCP Server

Справочник инструментов

Инструмент	Описание
`seedream_generate_image`	Генерация изображения по текстовому запросу с использованием модели ByteDance Seedream.
`seedream_edit_image`	Редактирование или изменение существующих изображений с использованием модели ByteDance Seedream/SeedEdit.
`seedream_get_task`	Запрос статуса и результата задачи генерации или редактирования изображения Seedream.
`seedream_get_tasks_batch`	Запрос нескольких задач изображений Seedream одновременно.
`seedream_list_models`	Список всех доступных моделей Seedream с их возможностями и ценами.
`seedream_list_sizes`	Список всех доступных размеров изображений и вариантов разрешения для Seedream.

Быстрый старт

1. Получите ваш API-токен

Зарегистрируйтесь на платформе AceDataCloud
Перейдите на страницу документации API
Нажмите "Acquire" (Получить), чтобы получить ваш API-токен
Скопируйте токен для использования ниже

2. Используйте размещенный сервер (рекомендуется)

AceDataCloud предоставляет управляемый MCP-сервер — локальная установка не требуется.

Эндпоинт: https://seedream.mcp.acedata.cloud/mcp

Все запросы требуют токен Bearer. Используйте API-токен из шага 1.

Claude.ai

Подключитесь напрямую на Claude.ai с помощью OAuth — API-токен не требуется:

Перейдите в Claude.ai Settings → Integrations → Add More
Введите URL сервера: https://seedream.mcp.acedata.cloud/mcp
Завершите процесс входа через OAuth
Начните использовать инструменты в вашем диалоге

Claude Desktop

Добавьте в вашу конфигурацию (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Cursor / Windsurf

Добавьте в вашу конфигурацию MCP (.cursor/mcp.json или .windsurf/mcp.json):

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

VS Code (Copilot)

Добавьте в вашу конфигурацию MCP VS Code (.vscode/mcp.json):

{
 "servers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Или установите расширение Ace Data Cloud MCP для VS Code, которое объединяет все 15 MCP-серверов с настройкой в один клик.

JetBrains IDEs

Перейдите в Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Нажмите Add → HTTP
Вставьте:

{
 "mcpServers": {
 "seedream": {
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Claude Code

Claude Code поддерживает MCP-серверы нативно:

claude mcp add seedream --transport http https://seedream.mcp.acedata.cloud/mcp \
 -h "Authorization: Bearer YOUR_API_TOKEN"

Или добавьте в .mcp.json вашего проекта:

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Cline

Добавьте в настройки MCP Cline (.cline/mcp_settings.json):

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Amazon Q Developer

Добавьте в вашу конфигурацию MCP:

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Roo Code

Добавьте в настройки MCP Roo Code:

{
 "mcpServers": {
 "seedream": {
 "type": "streamable-http",
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

Continue.dev

Добавьте в .continue/config.yaml:

mcpServers:
 - name: seedream
 type: streamable-http
 url: https://seedream.mcp.acedata.cloud/mcp
 headers:
 Authorization: "Bearer YOUR_API_TOKEN"

Zed

Добавьте в настройки Zed (~/.config/zed/settings.json):

{
 "language_models": {
 "mcp_servers": {
 "seedream": {
 "url": "https://seedream.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
 }
}

cURL Test

# Health check (no auth required)
curl https://seedream.mcp.acedata.cloud/health

# MCP initialize
curl -X POST https://seedream.mcp.acedata.cloud/mcp \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer YOUR_API_TOKEN" \
 -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

3. Или запустите локально (альтернатива)

Если вы предпочитаете запускать сервер на своей машине:

# Install from PyPI
pip install mcp-seedream-pro
# or
uvx mcp-seedream-pro

# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"

# Run (stdio mode for Claude Desktop / local clients)
mcp-seedream-pro

# Run (HTTP mode for remote access)
mcp-seedream-pro --transport http --port 8000

Claude Desktop (локально)

{
 "mcpServers": {
 "seedream": {
 "command": "uvx",
 "args": ["mcp-seedream-pro"],
 "env": {
 "ACEDATACLOUD_API_TOKEN": "your_token_here"
 }
 }
 }
}

Docker (самостоятельный хостинг)

docker pull ghcr.io/acedatacloud/mcp-seedream-pro:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-seedream-pro:latest

Клиенты подключаются со своим собственным токеном Bearer — сервер извлекает токен из заголовка Authorization каждого запроса.

Доступные инструменты

Генерация и редактирование изображений

Инструмент	Описание
`seedream_generate_image`	Генерация изображения по текстовому запросу
`seedream_edit_image`	Редактирование или изменение существующих изображений с помощью ИИ

Управление задачами

Инструмент	Описание
`seedream_get_task`	Запрос статуса и результата одной задачи
`seedream_get_tasks_batch`	Запрос нескольких задач одновременно

Информация

Инструмент	Описание
`seedream_list_models`	Список доступных моделей с их возможностями
`seedream_list_sizes`	Список доступных вариантов размера изображения

Доступные модели

Модель	Версия	Тип	Лучше всего подходит для	Цена
`doubao-seedream-5-0-260128`	v5.0	Текст в изображение	Лучшее качество, новейший флагман, веб-поиск	~$0.040/изобр.
`doubao-seedream-4-5-251128`	v4.5	Текст в изображение	Предыдущий флагман, отличное качество	~$0.037/изобр.
`doubao-seedream-4-0-250828`	v4.0	Текст в изображение	Лучшее соотношение цены и качества, большинство задач	~$0.030/изобр.
`doubao-seedream-3-0-t2i-250415`	v3.0	Текст в изображение	Воспроизводимые результаты	~$0.038/изобр.
`doubao-seededit-3-0-i2i-250628`	v3.0	Изображение в изображение	Редактирование изображений	~$0.046/изобр.

Примеры использования

Генерация изображения по запросу

User: Create a photorealistic image of a cat in a garden

Claude: I'll generate that image for you.
[Calls seedream_generate_image with detailed prompt]
→ Returns task_id and image URL

Редактирование изображений

User: Change the background of this photo to a beach
[Provides image URL]

Claude: I'll edit that image for you.
[Calls seedream_edit_image with image URL and edit description]

Поддержка запросов на китайском языке

User: 生成一幅中国山水画，有远山、流水和古松

Claude: 好的，我来为您生成这幅山水画。
[Calls seedream_generate_image with Chinese prompt]

Воспроизводимая генерация

User: Generate a landscape and make sure I can recreate the exact same image later

Claude: I'll use the v3 model with a fixed seed.
[Calls seedream_generate_image with model=doubao-seedream-3-0-t2i-250415, seed=42]

Конфигурация

Переменные окружения

Переменная	Описание	По умолчанию
`ACEDATACLOUD_API_TOKEN`	API-токен от AceDataCloud	Обязательно
`ACEDATACLOUD_API_BASE_URL`	Базовый URL API	`https://api.acedata.cloud`
`ACEDATACLOUD_OAUTH_CLIENT_ID`	OAuth client ID (режим хостинга)	—
`ACEDATACLOUD_PLATFORM_BASE_URL`	Базовый URL платформы	`https://platform.acedata.cloud`
`SEEDREAM_REQUEST_TIMEOUT`	Тайм-аут запроса в секундах	`1800`
`LOG_LEVEL`	Уровень логирования	`INFO`

Параметры командной строки

mcp-seedream-pro --help

Options:
 --version Show version
 --transport Transport mode: stdio (default) or http
 --port Port for HTTP transport (default: 8000)

Разработка

Настройка среды разработки

# Clone repository
git clone https://github.com/AceDataCloud/SeedreamMCP.git
cd SeedreamMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate # or `.venv\Scripts\activate` on Windows

# Install with dev dependencies
pip install -e ".[dev,test]"

Запуск тестов

# Run unit tests
pytest

# Run with coverage
pytest --cov=core --cov=tools

# Run integration tests (requires API token)
pytest -m integration

Качество кода

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools main.py

Сборка и публикация

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

Структура проекта

SeedreamMCP/
├── core/ # Core modules
│ ├── __init__.py
│ ├── client.py # HTTP client for Seedream API
│ ├── config.py # Configuration management
│ ├── exceptions.py # Custom exceptions
│ ├── server.py # MCP server initialization
│ ├── types.py # Type definitions
│ └── utils.py # Utility functions
├── tools/ # MCP tool definitions
│ ├── __init__.py
│ ├── image_tools.py # Image generation/editing tools
│ ├── task_tools.py # Task query tools
│ └── info_tools.py # Model & size info tools
├── prompts/ # MCP prompt templates
│ └── __init__.py
├── tests/ # Test suite
│ ├── conftest.py
│ ├── test_config.py
│ └── test_utils.py
├── deploy/ # Deployment configs
│ ├── run.sh
│ └── production/
│ ├── deployment.yaml
│ ├── ingress.yaml
│ └── service.yaml
├── .github/ # GitHub Actions workflows
│ ├── dependabot.yml
│ └── workflows/
│ ├── ci.yaml
│ ├── claude.yml
│ ├── deploy.yaml
│ └── publish.yml
├── .env.example # Environment template
├── .gitignore
├── .ruff.toml # Ruff linter config
├── CHANGELOG.md
├── Dockerfile # Docker image for HTTP mode
├── docker-compose.yaml # Docker Compose config
├── LICENSE
├── main.py # Entry point
├── pyproject.toml # Project configuration
└── README.md

Справочник API

Этот сервер является оберткой для AceDataCloud Seedream API:

Seedream Images API — Генерация и редактирование изображений
Seedream Tasks API — Запросы задач

Варианты использования

Создание ИИ-арта — генерация потрясающих иллюстраций и цифрового искусства
Предметная фотосъемка — создание профессиональных композиций сцен с продуктами
Создание контента — генерация изображений для блогов, социальных сетей, маркетинга
Виртуальная примерка — визуализация одежды на разных моделях
Перенос стиля — преобразование фотографий в различные художественные стили
Дизайн игр — концепт-арт, дизайн персонажей, дизайн окружения
Электронная коммерция — макеты продуктов, лайфстайл-снимки, баннеры

Лицензия

MIT License - подробности см. в файле LICENSE.

Ссылки

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

1dResponse time

1dRelease cycle

52Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AceDataCloud/SeedreamMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

URL: https://glama.ai/mcp/servers/AceDataCloud/SeedreamMCP?locale=ru-RU

⇱ SeedreamMCP by AceDataCloud | Glama