Seedream_MCP

Seedream_MCP exposes a cloud-based MCP (Model Context Protocol) interface that wraps the Seedream 4.0 and Seedream 4.5 image generation capabilities. It provides several generation tools via a single MCP endpoint, including text-to-image, image-to-image style transfer, multi-image fusion, sequential image generation, and a local image browser to prepare inputs. You can drive these tools using the uvx-based command shown in the installation section, or configure Claude Desktop to point at the MCP server. Typical usage involves providing an API key and selecting the desired model (Seedream 4.0 or 4.5) along with common options like size, watermark, and transport mode. The available tools enable you to perform creative prompts, transform existing images, fuse multiple images, and generate image sequences suitable for concept art or storyboard workflows.

Prerequisites:

• Git and curl/wget
• uvx installer (per the Quick Install steps below)
• An API key from the provider (ARK API key)

Step-by-step installation:

1. Install uvx (if not already installed): curl -LsSf https://astral.sh/uv/install.sh | sh

2. Install or clone Seedream MCP via uvx (recommended one-shot start): uvx git+https://github.com/tengmmvp/Seedream_MCP --api-key your_api_key_here

3. Alternatively, clone locally and run from the repository: git clone https://github.com/tengmmvp/Seedream_MCP cd Seedream_MCP uvx . --api-key your_api_key_here

4. If you prefer Docker Compose (for deployment): curl -O https://raw.githubusercontent.com/tengmmvp/Seedream_MCP/main/docker-compose.yml ARK_API_KEY=your_api_key_here docker-compose up -d

Notes:

• Replace your_api_key_here with your actual API key.
• Ensure ARK_API_KEY is set when using Docker Compose (or pass as environment in your deployment).
• The MCP supports multiple transport options (stdio, sse, streamable-http) via the --transport flag when using uvx.

Tips and common notes:

• The MCP supports multiple models; specify --model doubao-seedream-4.0 or doubao-seedream-4.5 to choose.
• Useful transport modes include stdio, sse, and streamable-http; use --transport with uvx to enable the desired mechanism and --mount-path for SSE when needed.
• Claude Desktop users can add the seedream entry in claude_desktop_config.json, pointing to the uvx command and your API key.
• If uvx command is not found, install uvx first or ensure it is available in your PATH.
• When operating behind firewalls or proxies, ensure network access to the Seedream MCP repository and the API key is allowed.
• The Seedream tools offer: text-to-image generation (seedream_text_to_image), image-to-image style transformation (seedream_image_to_image), multi-image fusion (seedream_multi_image_fusion), sequential generation (seedream_sequential_generation), and image browsing (seedream_browse_images) for input preparation.