Seedream MCP 接続ガイド

MCP（Model Context Protocol）はAnthropicが提供するモデルコンテキストプロトコルで、ClaudeやGPTなどのAIモデルが標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。AceData Cloudが提供するSeedream MCP Serverを利用することで、Claude Desktop、VS Code、CursorなどのAIクライアント上で直接ByteDanceのSeedreamを使ったAI画像の生成や編集が行えます。

機能概要

Seedream MCP Serverは以下の主要機能を提供します：

テキストから画像生成 — テキストプロンプトを用いて高品質な画像を生成（日本語・英語のプロンプト対応）
画像編集 — 既存画像のスタイル、背景、属性などを変更
バーチャル試着 — 人物写真に服装を着せる
複数モデル対応 — Seedream v4.5、v4.0、v3.0 T2I、SeedEdit v3.0 I2Iなどのモデルをサポート
多様な解像度 — 1K、2K、4Kおよび適応解像度に対応
シード制御 — seedパラメータによる再現可能な生成結果の実現
タスク照会 — 生成進捗の監視および結果取得

事前準備

利用前にAceData CloudのAPIトークンを取得してください：

AceData Cloudプラットフォームに登録またはログイン
Seedream Images APIページへ移動
「Acquire」をクリックしてAPIトークンを取得（初回申請時に無料クレジット付与）

インストールと設定

方法1：pipインストール（推奨）

pip install mcp-seedream-pro

方法2：ソースコードからインストール

git clone https://github.com/AceDataCloud/SeedreamMCP.git
cd SeedreamMCP
pip install -e .

インストール完了後、mcp-seedream-pro コマンドでサービスを起動できます。

Claude Desktopでの利用

Claude Desktopの設定ファイルを編集します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加してください：

{
  "mcpServers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

uvx（事前にパッケージをインストール不要）を使う場合：

{
  "mcpServers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

設定保存後、Claude Desktopを再起動するとSeedream関連ツールが会話内で利用可能になります。

VS Code / Cursorでの利用

プロジェクトのルートディレクトリに .vscode/mcp.json を作成します：

{
  "servers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

または uvx を使う場合：

{
  "servers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

利用可能なツール一覧

ツール名	説明
`seedream_generate_image`	テキストプロンプトから画像生成
`seedream_edit_image`	既存画像の編集・修正
`seedream_get_task`	単一タスクの状態照会
`seedream_get_tasks_batch`	複数タスクの状態一括照会
`seedream_list_models`	利用可能なモデルと機能の一覧表示
`seedream_list_sizes`	利用可能な画像サイズ・解像度一覧

使用例

設定完了後、AIクライアント内で自然言語により以下のような操作が可能です：

「Seedreamで水墨画風の山水画を生成して」
「この写真の背景を星空に変えて」
「Seedream v4.5で4K高解像度のポートレートを生成して」
「この服をこの写真の人物にバーチャル試着させて」

参考情報

GitHubリポジトリ：AceDataCloud/SeedreamMCP
PyPIパッケージ：mcp-seedream-pro
APIドキュメント：Seedream 画像生成API

​機能概要

​事前準備

​インストールと設定

​方法1：pipインストール（推奨）

​方法2：ソースコードからインストール

​Claude Desktopでの利用

​VS Code / Cursorでの利用

​利用可能なツール一覧

​使用例

​参考情報