SeedreamMCP

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

ByteDanceのSeedreamモデルをAceDataCloud API経由で利用し、AI画像生成および編集を行うためのModel Context Protocol (MCP)サーバーです。

Claude、VS Code、またはMCP互換クライアントから直接AI画像を生成・編集できます。

機能

テキストからの画像生成 — テキストプロンプト（中国語および英語）から高品質な画像を生成
画像編集 — AIを使用して既存の画像を編集（スタイル変換、背景変更、バーチャル試着）
複数モデル — Seedream v5.0（フラッグシップ）、v4.5、v4.0、v3.0 T2I、SeedEdit v3.0 I2I
マルチ解像度 — 1K、2K、3K、4K、アダプティブ、およびカスタムサイズ
シード値制御 — シードパラメータによる再現可能な結果（v3モデル）
シーケンシャル生成 — 関連画像を連続して生成（v4.5/v4.0）
ストリーミング — プログレッシブな画像配信（v4.5/v4.0）
タスク追跡 — 生成の進捗状況の監視と結果の取得

Related MCP server: Seedream 4.0 MCP Server

ツールリファレンス

ツール	説明
`seedream_generate_image`	ByteDanceのSeedreamモデルを使用してテキストプロンプトからAI画像を生成します。
`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トークンが必要です。ステップ1で取得したAPIトークンを使用してください。

Claude.ai

Claude.aiでOAuthを使用して直接接続します（APIトークンは不要です）：

Claude.aiの設定 → 統合 → その他を追加に移動します
サーバーURLを入力します: https://seedream.mcp.acedata.cloud/mcp
OAuthログインフローを完了します
会話内でツールを使用し始めます

Claude Desktop

設定ファイル（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
 "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)

VS CodeのMCP設定（.vscode/mcp.json）に追加します：

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

または、VS Code用のAce Data Cloud MCP拡張機能をインストールしてください。15個のMCPサーバーすべてがワンクリックでセットアップされます。

JetBrains IDEs

**設定 → ツール → AI Assistant → Model Context Protocol (MCP)**に移動します
追加 → 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

ClineのMCP設定（.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

Roo CodeのMCP設定に追加します：

{
 "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テスト

# 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`	AIを使用して既存の画像を編集または修正

タスク管理

ツール	説明
`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`	AceDataCloudのAPIトークン	必須
`ACEDATACLOUD_API_BASE_URL`	APIベースURL	`https://api.acedata.cloud`
`ACEDATACLOUD_OAUTH_CLIENT_ID`	OAuthクライアント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 — タスク照会

ユースケース

AIアート制作 — 見事なアートワーク、イラスト、デジタルアートの生成
商品写真 — プロフェッショナルな商品シーン構成の作成
コンテンツ制作 — ブログ、SNS、マーケティング用画像の生成
バーチャル試着 — さまざまなモデルでの衣服の視覚化
スタイル変換 — 写真を異なるアートスタイルに変換
ゲームデザイン — コンセプトアート、キャラクターデザイン、環境デザイン
Eコマース — 商品モックアップ、ライフスタイルショット、バナー画像

ライセンス

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=ja-JP

⇱ SeedreamMCP by AceDataCloud | Glama