undefined

**Restart Claude Code** after installation.

{
  "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

undefined

undefined

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

undefined

**Full CLI flags:**
```bash
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

undefined

/meigen:models

Available models depend on your provider:
- **MeiGen Cloud**: `nanobanana-2`, `gpt-image-2`, `seedream-5.0`, `midjourney-v8.1`, `flux-2-klein`, `seedance-2.0-fast`, `seedance-2.0-pro`, `happyhorse-1.0`, `veo-3.1`
- **ComfyUI**: Uses local workflows, model specified in workflow JSON
- **OpenAI-compatible**: `dall-e-3`, `dall-e-2`, or custom models at your endpoint