BytePlus Image MCP

MCP server untuk generate image via BytePlus ModelArk (keluarga model Seedream dari ByteDance) — dirancang untuk kebutuhan logo, mockup UI/UX, dan ilustrasi dokumen/proposal.

✨ Fitur

• Auto-routing model cerdas — sebut purpose saja, model dipilih otomatis:

  • logo / mockup → Seedream 4.5 (text rendering terbaik, 4K)

  • document → Seedream 4.0 (hemat, cukup untuk ilustrasi)

• Multi-gambar per request (1–6), resolusi 1K/2K/4K

• Seed reproducible untuk hasil konsisten

• Auto-download hasil ke folder lokal

• Error handling lengkap dengan solusi konkret (Bahasa Indonesia)

Related MCP server: Volcengine Image Generation MCP Server

📊 Model

*Kuota gratis akun baru BytePlus. Daftar di console.byteplus.com.

🚀 Install

Prasyarat

1. Akun BytePlus dengan API key (ModelArk → API keys)

2. Aktifkan model Seedream di ModelArk → Model activation → tab Media

3. Python ≥ 3.10 dan uv (opsional tapi disarankan)

Cara 1: uvx langsung dari GitHub (tanpa install manual)

{
  "mcpServers": {
    "byteplus-image": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/alecslacker/byteplus-image-mcp", "byteplus-image-mcp"],
      "env": {
        "BYTEPLUS_API_KEY": "isi-api-key-anda"
      }
    }
  }
}

Cara 2: pip install dari GitHub

pip install git+https://github.com/alecslacker/byteplus-image-mcp

Lalu di config MCP client:

{
  "mcpServers": {
    "byteplus-image": {
      "command": "byteplus-image-mcp",
      "env": { "BYTEPLUS_API_KEY": "isi-api-key-anda" }
    }
  }
}

Cara 3: jalankan file langsung (lokal)

git clone https://github.com/alecslacker/byteplus-image-mcp
cd byteplus-image-mcp
pip install mcp httpx pydantic
BYTEPLUS_API_KEY=isi-api-key-anda python src/byteplus_image_mcp/server.py

⚙️ Environment Variables

🛠️ Tools

byteplus_generate_image

Contoh pemakaian:

"Buatkan logo Duta Corpora"
→ byteplus_generate_image({
     prompt: "minimalist geometric logo, letter D monogram, gold on navy, flat vector",
     purpose: "logo"
   })

"Ilustrasi cover proposal"
→ byteplus_generate_image({
     prompt: "abstract tech illustration, flowing data lines, blue gradient",
     purpose: "document"
   })

byteplus_list_models

Lihat daftar model + harga + panduan pemilihan.

📁 Output

Gambar tersimpan di BYTEPLUS_IMAGE_OUTPUT_DIR dengan nama {timestamp}-{slug-prompt}-{index}.jpg. URL dari API valid 24 jam; file lokal permanen.

🔒 Keamanan

• API key hanya via environment variable — tidak pernah di-hardcode

• Jangan commit .env atau key ke repository

• Monitor pemakaian: console.byteplus.com → ModelArk → Usage

📄 Lisensi

MIT — lihat LICENSE.