# Via MeiGen marketplace
/plugin marketplace add jau123/MeiGen-AI-Design-MCP
/plugin install meigen@meigen-marketplace

# Or via wshobson/agents (30k+ stars)
/plugin marketplace add wshobson/agents
/plugin install meigen-ai-design@claude-code-workflows

{
  "mcpServers": {
    "meigen": {
      "command": "npx",
      "args": ["-y", "meigen@1.3.1"],
      "env": {
        "MEIGEN_API_TOKEN": "${MEIGEN_API_TOKEN}"
      }
    }
  }
}

npx meigen init cursor      # Cursor
npx meigen init vscode      # VS Code
npx meigen init windsurf    # Windsurf
npx meigen init roo         # Roo Code

# Full plugin (commands + skills + MCP)
openclaw bundles install clawhub:meigen-ai-design

# Or skill only
npx clawhub@latest install creative-toolkit

mcp_servers:
  meigen:
    command: "npx"
    args: ["-y", "meigen@1.3.1"]
    env:
      MEIGEN_API_TOKEN: "${MEIGEN_API_TOKEN}"
    timeout: 600          # Video generation can take 5-10 min
    connect_timeout: 120  # First npx download needs time

/meigen:setup

{
  "comfyuiUrl": "http://localhost:8188",
  "comfyuiDefaultWorkflow": "txt2img"
}

COMFYUI_URL=http://localhost:8188
COMFYUI_DEFAULT_WORKFLOW=txt2img

{
  "meigenApiToken": "meigen_sk_..."
}

MEIGEN_API_TOKEN=meigen_sk_...

{
  "openaiCompatibleApiKey": "sk-...",
  "openaiCompatibleEndpoint": "https://api.openai.com/v1"
}

OPENAI_API_KEY=sk-...
OPENAI_API_BASE=https://api.openai.com/v1

const result = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "search_gallery",
  arguments: {
    keywords: "product photography luxury",
    limit: 10
  }
});

const inspiration = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "get_inspiration",
  arguments: {
    id: "nanobanana_12345"
  }
});

const enhanced = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "enhance_prompt",
  arguments: {
    userPrompt: "cat in kitchen",
    style: "photorealistic",
    additionalContext: "sunlit, warm tones"
  }
});

const models = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "list_models",
  arguments: {}
});

const image = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "generate_image",
  arguments: {
    prompt: "a minimalist tech logo, geometric shapes, blue gradient",
    model: "midjourney-v8.1",
    aspectRatio: "1:1",
    referenceImagePath: "/Users/dev/Desktop/sketch.jpg"  // Optional
  }
});

const video = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "generate_video",
  arguments: {
    prompt: "Camera slowly zooms into the perfume bottle, bokeh background",
    model: "seedance-2.0-fast",
    firstFrameImagePath: "/Users/dev/Pictures/bottle.jpg",  // Optional
    duration: 5
  }
});

// List workflows
const workflows = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "comfyui_workflow",
  arguments: {
    action: "list"
  }
});

// View a workflow
const workflow = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "comfyui_workflow",
  arguments: {
    action: "view",
    name: "txt2img"
  }
});

// Import a workflow
await use_mcp_tool({
  server_name: "meigen",
  tool_name: "comfyui_workflow",
  arguments: {
    action: "import",
    name: "custom-flux",
    workflow: JSON.stringify(workflowJson)
  }
});

await use_mcp_tool({
  server_name: "meigen",
  tool_name: "manage_preferences",
  arguments: {
    action: "set",
    key: "preferredStyle",
    value: "minimalist editorial"
  }
});

const prefs = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "manage_preferences",
  arguments: {
    action: "get"
  }
});

/meigen:gen a calico cat in a sunlit kitchen, photorealistic
/meigen:find luxury product photography
/meigen:models

# Set token once
export MEIGEN_API_TOKEN=meigen_sk_...

# Basic generation
npx meigen gen --prompt "a calico cat in a sunlit kitchen"

# Specific model + aspect ratio
npx meigen gen -p "tech logo" -m midjourney-v8.1 -r 1:1

# With reference image
npx meigen gen -p "product hero shot" --ref ~/Desktop/bottle.jpg

# Submit only (no polling, good for CI)
npx meigen gen -p "..." --no-wait

# Machine-readable output (pipe to jq)
npx meigen gen -p "..." --json | jq -r '.imageUrls[0]'

npx meigen gen --help

Options:
  -p, --prompt <text>        Image prompt (required)
  -m, --model <name>         Model name (default: nanobanana-2)
  -r, --ratio <ratio>        Aspect ratio (e.g. 16:9, 1:1, 3:4)
  --ref <path>               Reference image path
  --no-wait                  Submit only, don't poll for result
  --json                     Machine-readable JSON output
  -h, --help                 Display help

A pristine white ceramic coffee cup on a dark walnut desk, steam rising 
gracefully, shot with shallow depth of field, warm morning light streaming 
through venetian blinds creating dramatic shadows, cinematic color grading, 
shot on Arri Alexa, 35mm lens, f/1.4

// Read workflow from file
const workflowJson = JSON.parse(
  fs.readFileSync('path/to/workflow_api.json', 'utf8')
);

// Import into MeiGen
await use_mcp_tool({
  server_name: "meigen",
  tool_name: "comfyui_workflow",
  arguments: {
    action: "import",
    name: "flux-lora-custom",
    workflow: JSON.stringify(workflowJson)
  }
});

// Use it
await use_mcp_tool({
  server_name: "meigen",
  tool_name: "generate_image",
  arguments: {
    prompt: "cyberpunk street scene",
    model: "comfyui",
    workflow: "flux-lora-custom"
  }
});

const video = await use_mcp_tool({
  server_name: "meigen",
  tool_name: "generate_video",
  arguments: {
    prompt: "Slow camera push towards product, bokeh background, cinematic lighting",
    model: "seedance-2.0-fast",
    firstFrameImagePath: "/Users/dev/Desktop/product.jpg",
    duration: 5
  }
});

/meigen:setup
# Or set environment variables manually:
export MEIGEN_API_TOKEN=meigen_sk_...

/meigen:models
# Or use tool:
use_mcp_tool({
  server_name: "meigen",
  tool_name: "list_models",
  arguments: {}
})