MeiGen-AI-Design-MCP

<h1 align="center"> MeiGen AI Design MCP <a href="https://github.com/punkpeye/awesome-mcp-servers"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome MCP Servers"></a> <a href="https://github.com/wshobson/agents/tree/main/plugins/meigen-ai-design"><img src="https://img.shields.io/badge/wshobson%2Fagents-Featured-blue?style=flat&logo=github" alt="Featured in wshobson/agents"></a> </h1> <p align="center"> <strong>Open-source MCP server for AI image &amp; video generation — native to every major AI coding tool</strong><br>_{Leading models (GPT Image 2 · Nanobanana 2 · Seedream 5.0 · Midjourney V8.1 · Flux 2 Klein · Grok Imagine · Seedance 2.0 · Veo 3.1 · Grok Video · Agnes Video · local ComfyUI) · 1,446 curated prompts · parallel sub-agent orchestration · standalone CLI mode. Works in Claude Code, Cursor, Codex, Windsurf, Roo Code, OpenClaw, Hermes Agent, and any MCP-compatible host.} </p> <p align="center"> <a href="https://www.npmjs.com/package/meigen"><img src="https://img.shields.io/npm/v/meigen?style=flat-square&color=blue" alt="npm version"></a> <a href="https://www.npmjs.com/package/meigen"><img src="https://img.shields.io/npm/dm/meigen?style=flat-square&color=green" alt="npm downloads"></a> <img src="https://img.shields.io/badge/Type-MCP_Server-blue?style=flat-square" alt="MCP Server"> <img src="https://img.shields.io/badge/Local-ComfyUI-green?style=flat-square" alt="ComfyUI Support"> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-lightgrey?style=flat-square" alt="MIT"></a> <a href="https://discord.gg/uX6rnersUx"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> </p> <p align="center"> <a href="#quick-start">Quick Start</a> &bull; <a href="#skills">Five Skills</a> &bull; <a href="SKILLS_API.md">HTTP API</a> &bull; <a href="#upgrading">Upgrade to 2.0</a> &bull; <a href="#see-it-in-action">Demo</a> &bull; <a href="#features">Features</a> &bull; <a href="#providers">Providers</a> &bull; <a href="#slash-commands">Commands</a> </p> <p align="center"> <strong>English</strong> | <a href="README.zh-CN.md">中文</a> </p>

---

New in 2.0.1: generate_video accepts multiple reference videos and reference audio (referenceVideos / referenceAudios; local .mp4/.mov/.wav/.mp3 files are uploaded automatically). Per-model limits come from list_models.

New in 2.0.0: five guided ecommerce/image Skills, original-image enhancement, upload validation, request recovery and Codex setup. Use a Skill · Upgrade guide · HTTP API

What Is This?

An MCP server that helps your AI assistant create images, videos and ecommerce assets. Connect to the remote server (14 tools) or install the local npm server (17 tools). Works in Claude Code, Cursor, Codex, Windsurf, Roo Code, OpenClaw, Hermes Agent, and other compatible MCP hosts.

Version 2.0.0 adds five guided Skills: background removal, Product Detail Images, Marketing Poster, AI Backgrounds and Upscale. These run on MeiGen Cloud and require a MeiGen API key and purchased credits. The local server also supports OpenAI-compatible APIs and ComfyUI for general image generation; those providers do not run the five Skills.

• Local general image generation supports three backends: MeiGen Cloud, OpenAI-compatible APIs, or local ComfyUI. Use list_models for current capabilities.
• Built-in 1,446 curated prompt templates from nanobanana-trending-prompts plus style-aware prompt enhancement
• Callable image/video steps for upstream workflows, optional creative helpers, and a standalone CLI for shell scripts and CI

---

See It in Action

<p align="center"> <a href="https://youtu.be/JQ3DZ1DXqvs"> <img src="https://img.youtube.com/vi/JQ3DZ1DXqvs/maxresdefault.jpg" alt="Watch Demo" width="400"> </a> <br> <b><a href="https://youtu.be/JQ3DZ1DXqvs">▶ Watch demo on YouTube</a></b> </p>

Product Photo — 4 Directions in Parallel

"Create 4 product display images for this perfume, one of which should feature a model."

Process — AI uploads the reference image, crafts 4 distinct prompts, then generates all 4 in parallel:

<p align="center"> <img src="assets/demo-process.jpg" alt="Parallel generation process" width="700"> </p>

Result — 4 creative directions delivered in under 2 minutes:

<p align="center"> <img src="assets/demo-result.jpg" alt="Generation results" width="700"> </p>

Generated images:

<p align="center"> <img src="assets/sample-luxury.jpg" alt="Luxury still life" width="24%"> <img src="assets/sample-model.jpg" alt="Model campaign" width="24%"> <img src="assets/sample-botanicals.jpg" alt="Nature botanicals" width="24%"> <img src="assets/sample-minimal.jpg" alt="Minimalist editorial" width="24%"> </p>

---

Quick Start

<a id="install-with-ai"></a>

Ask your AI assistant to install

Copy this entire block into Codex, Claude Code, Cursor, or another AI assistant that can configure MCP servers. It can set up the connection and guide you through credentials. ChatGPT web uses the separate setup below.

Install MeiGen MCP for this AI client using this guide:
https://github.com/jau123/MeiGen-AI-Design-MCP#quick-start

Detect the current client and inspect its MCP configuration without printing
credentials. Preserve other servers and reuse an existing MeiGen entry.
Prefer Streamable HTTP at https://www.meigen.ai/api/mcp. For Codex, use
codex mcp add meigen --url https://www.meigen.ai/api/mcp
Add bearer_token_env_var = "MEIG…[redacted]" only after that local
environment variable is configured; otherwise leave authentication unset.
If I need automatic local-file preparation, ComfyUI, or local-only tools, use
the stdio command npx -y meigen@2.0.1 instead. Check that this exact npm
version exists before configuring it; report an unavailable version.
Guide me to enter my MeiGen key in local credentials settings or the launch
environment, never in this chat. Public lookups can be tested without a key.
Reload/reconnect, inspect the actual tool list, and call list_skills to verify.
If you cannot configure or reconnect this client, give me the exact manual
steps and say what remains unverified. If list_skills is missing, report it.
Do not upload images, generate anything, or spend credits during installation.

For manual setup, jump to Codex / ChatGPT desktop, ChatGPT web, or the client-specific instructions below.

1. Prepare your account

You can browse inspiration and inspect models or Skill prices without a key. To generate with MeiGen:

1. Open API Keys in a desktop browser, sign in, and create a key. The key starts with meigen_sk_; the mobile site currently redirects this page.
2. Open your profile and select Top Up to add purchased credits to the same account; on mobile use Premium. API generation does not use daily free credits; the five Skills have no free attempts, including the first cutout. Use list_skills for current Skill prices.
3. Add the key to your MCP host's connection settings. Keep it out of chat messages and shared config files.

2. Choose one connection

| | Remote MCP — recommended | Local npm MCP 2.0.1 | |---|---|---| | Connection | Streamable HTTP at https://www.meigen.ai/api/mcp | Node.js process over stdio | | Tools | 14: MeiGen generation, gallery and the five Skills | The same 14, plus prompt enhancement, preferences and ComfyUI management | | Reference images | Public image link, an existing MeiGen URL, or actual attachment bytes readable by the host | Local files and public image links are prepared automatically | | Local extras | Result URLs; the host handles preview/download | General generation saves files; also CLI, offline prompt library and local ComfyUI | | Plugin extras | A bare MCP connection does not install commands, agents, output styles or hooks | The Claude Code plugin adds these; a bare npm connection also does not include them | | Updates | Backend changes arrive after server deployment; refresh/reconnect if the host caches tools | Local tool changes require an npm release and a client update |

Choose one server entry for this host to avoid duplicate tools. The two entries use the same MeiGen account and purchased credits.

Install for your client: Remote settings · Codex · Claude Code · Cursor / VS Code / Windsurf / Roo · OpenClaw · ChatGPT web.

<a id="skills"></a>

3. Try your first Skill

After connecting, ask: “List the available Skills and their current prices.” This does not generate an image or spend generation credits. Then provide the required material and describe the result you want:

| Skill / tool | Example request | Required | Optional | Output and cost | |---|---|---|---|---| | Background removal — remove_background | “Remove this background and give me a transparent PNG.” | One source image | No creative brief needed | One cutout; charged from the first request | | Product Detail Images — generate_product_detail_images | “Use this product photo to make a main shot, a detail close-up and a lifestyle image.” | One product image; resolve the desired count/modules | Product name, selling points, copy, logo, model photo, up to two extra product photos, language and marketplace | 1–6 images; one paid image per module | | Marketing Poster — generate_marketing_poster | “Make one poster for a weekend coffee tasting.” | A brand, event, campaign or topic | Display copy, logo, up to three product images, one style reference, language and style | One poster; images are optional | | AI Backgrounds — generate_ai_background | “Put this product on a sunlit stone counter.” | One product image; desired setting for custom mode | White/smart/custom mode, ratio and quality | One product image with a new background; not a transparent cutout | | Upscale — upscale_image | “Make this original product photo clearer while keeping its appearance.” | One original still PNG/JPEG/WebP image | crisp preserves structure (default); creative reconstructs details and requires acceptance of changes | One enhanced image; video enhancement is not exposed |

The assistant chooses the tool, prepares images, checks status and presents preview/download links. You do not need to write prompts, UUIDs or API parameters. It asks only for missing essential information. An explicit request for a specified count, modules or quality already confirms that scope.

Product-detail batches: choose 1–6 modules in total. The presets are main shot (hero), close-up (detail), lifestyle (scene), texture/craft (material), how-to-use (usage) and brand story (brand); custom modules are also supported. MCP requires the assistant to pass modules explicitly, preventing extra images when an argument is omitted. You can specify only the count and let the assistant choose modules. Direct HTTP API calls still default to three images (hero, detail and scene) when modules are omitted. The assistant should calculate the batch cost from the live per-image price and requested count before submitting an unresolved batch.

Copy and quality: ask to preserve your wording when exact copy matters; otherwise the service can draft copy from your brief. State the desired text language. Product details and posters default to Fast; Pro costs more. AI Backgrounds defaults to smart/Fast; white mode uses a fixed output specification and ignores ratio/quality options. Current options and prices come from list_skills.

Poster fields: with autoCopy: true, content is a brief; with `a