seedream-image-mcp

# SeeDream Image MCP MCP (Model Context Protocol) image generation tool based on Volcengine SeeDream model. ## ✨ Features - 🎨 Generate high-quality images using the Volcengine SeeDream 4.0 model - 🔧 Supports custom sizes, intelligent reference images, etc. - 📝 No need to write complex prompts, AI automatically generates image generation prompts based on requirements - 🔌 MCP protocol support, can be used in clients such as Cursor, Claude Desktop ## 📺 Demo <video src="https://github.com/user-attachments/assets/2b82a9d4-7799-4625-a140-2a48845b2e4a" autoplay muted loop playsinline controls width="100%" height="auto"></video> ## 🚀 Quick Start ### 1. Get Volcengine API Key Go to [Volcengine->Volcengine Ark Console](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey) to activate the service and apply for an API Key. ### 2. Run with npx ```bash npx seedream-image-mcp --ark-key=YOUR_API_KEY ``` ### 3. Configure in Cursor, Claude Desktop Edit `Cursor MCP配置` or `claude_desktop_config.json`: ```json { "mcpServers": { "seedream-image": { "command": "npx", "args": ["seedream-image-mcp", "--ark-key=YOUR_API_KEY"] } } } ``` ## 📖 Usage Example In the AI Agent tool, you can use it like this: ``` 为这个页面添加合适的图片，避免过于单调 ``` AI will automatically call the tool to complete the generation. ## 📌 Notes **Image Link Validity**: This project uses the Volcengine original API, and the generated image links usually expire after 24 hours. If you need to save the images for a long time, please download them to your local device in time. ## 🔄 Two Usage Methods You can choose according to your needs: ### Method 1: Run Locally 🔧 - Need to apply for Volcengine API key yourself - Image link expires after 24 hours, need to download to local for use. ### Method 2: Cloud Version ✨ - ✅ No need to apply for API key, out of the box - ✅ Image supports permanent storage in CDN - ✅ Supports webp compression, background removal, fast concurrent generation of multiple images, etc. - ✅ Provides a certain amount of free quota - ✅ More favorable price for large quantities 👉 Learn about the cloud version: [https://mcp.pixelark.art](https://mcp.pixelark.art) --- ## 🛠️ Development ### Install Dependencies ```bash bun install ``` ### Run Locally ```bash bun run src/index.ts --ark-key=YOUR_API_KEY ``` ## 📄 License MIT ## 🔗 Related Links - [Cloud Version](https://mcp.pixelark.art) - [Volcengine SeeDream](https://www.volcengine.com/docs/ark/doubao-seedream) - [MCP Protocol](https://modelcontextprotocol.io)