Merge pull request #446 from jau123/add-meigen-ai-design

Add meigen-ai-design plugin

.claude-plugin/marketplace.json

@@ -945,6 +945,19 @@
       "homepage": "https://github.com/wshobson/agents",
       "license": "MIT",
       "category": "languages"
+    },
+    {
+      "name": "meigen-ai-design",
+      "source": "./plugins/meigen-ai-design",
+      "description": "AI image generation with creative workflow orchestration, prompt engineering, and curated inspiration library via MCP server",
+      "version": "1.0.0",
+      "author": {
+        "name": "MeiGen",
+        "url": "https://github.com/jau123"
+      },
+      "homepage": "https://github.com/jau123/MeiGen-AI-Design-MCP",
+      "license": "MIT",
+      "category": "creative"
     }
   ]
 }

plugins/meigen-ai-design/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "meigen-ai-design",
+  "version": "1.0.0",
+  "description": "AI image generation with creative workflow orchestration, parallel multi-direction output, prompt engineering, and a 1,300+ curated inspiration library. Requires MeiGen MCP server (supports MeiGen Cloud, local ComfyUI, and OpenAI-compatible APIs).",
+  "author": {
+    "name": "MeiGen",
+    "url": "https://www.meigen.ai"
+  },
+  "license": "MIT"
+}

plugins/meigen-ai-design/README.md

@@ -0,0 +1,112 @@
+# MeiGen AI Design
+
+AI image generation plugin with creative workflow orchestration, parallel multi-direction output, prompt engineering, and a 1,300+ curated inspiration library.
+
+## Prerequisites
+
+This plugin requires the **meigen** MCP server. Install it by adding to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "meigen": {
+      "command": "npx",
+      "args": ["-y", "meigen@1.2.5"]
+    }
+  }
+}
+```
+
+**Restart Claude Code** after adding the configuration.
+
+Requires Node.js 18+.
+
+## Provider Setup
+
+Configure at least one provider to enable image generation. **Free features** (gallery search, prompt enhancement, model listing, preference management) work without any provider configured.
+
+### Option A: MeiGen Cloud (Recommended)
+
+1. Sign up at [meigen.ai](https://www.meigen.ai)
+2. Click avatar → Settings → API Keys → create a new key (starts with `meigen_sk_`)
+3. Set environment variable:
+
+```bash
+export MEIGEN_API_TOKEN=meigen_sk_your_token_here
+```
+
+### Option B: Local ComfyUI (Free, Private)
+
+1. Install and run [ComfyUI](https://github.com/comfyanonymous/ComfyUI)
+2. Set environment variable:
+
+```bash
+export COMFYUI_URL=http://localhost:8188
+```
+
+3. Export workflows from ComfyUI (API format JSON) and import via the plugin
+
+### Option C: OpenAI-compatible API (Bring Your Own Key)
+
+Works with any OpenAI-compatible image generation API (OpenAI, Together AI, Fireworks AI, etc.):
+
+```bash
+export OPENAI_API_KEY=your_key_here
+export OPENAI_BASE_URL=https://api.openai.com/v1
+export OPENAI_MODEL=gpt-image-1
+```
+
+Alternatively, store configuration in `~/.config/meigen/config.json`.
+
+## Agents
+
+| Agent | Model | Purpose |
+|-------|-------|---------|
+| `gallery-researcher` | haiku | Search 1,300+ curated gallery, find references, build mood boards |
+| `prompt-crafter` | haiku | Write multiple distinct prompts for parallel image generation |
+| `image-generator` | inherit | Execute `generate_image` calls and relay results |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/meigen-ai-design:gen <prompt>` | Quick image generation — skips intent assessment |
+| `/meigen-ai-design:find <keywords>` | Quick gallery search — browse inspiration |
+
+## Free Features (No API Key)
+
+These tools work immediately without any provider setup:
+- **search_gallery** — Search 1,300+ curated AI image prompts
+- **enhance_prompt** — Expand brief descriptions into detailed generation prompts
+- **list_models** — List available models across all configured providers
+- **manage_preferences** — Save default style, aspect ratio, and favorite prompts
+
+## Verification
+
+After setup, test with a free feature:
+> "Search the gallery for product photography inspiration"
+
+Then test generation:
+> "Generate a product photo for a glass perfume bottle on marble"
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| MCP tools not available | Restart Claude Code after adding `.mcp.json` configuration |
+| "No image generation providers configured" | Configure at least one provider (see Provider Setup above) |
+| API key / authentication errors | Verify env vars or check `~/.config/meigen/config.json` |
+| ComfyUI connection refused | Ensure ComfyUI is running at the configured URL |
+| Generation timeout | Server may be under high load — try again in a moment |
+| Empty gallery search results | Try different keywords or broader terms |
+
+## Links
+
+- [npm package](https://www.npmjs.com/package/meigen)
+- [GitHub](https://github.com/jau123/MeiGen-AI-Design-MCP)
+- [Homepage](https://www.meigen.ai)
+- [Demo Video](https://youtu.be/JQ3DZ1DXqvs)
+
+## License
+
+MIT

plugins/meigen-ai-design/agents/gallery-researcher.md

@@ -0,0 +1,43 @@
+---
+description: >-
+  Gallery search and inspiration agent. Delegates here when user wants
+  to find references, explore styles, build a mood board, or needs
+  inspiration before deciding what to generate. Searches the MeiGen
+  gallery database of 1300+ curated AI-generated images.
+model: haiku
+tools: mcp__meigen__search_gallery, mcp__meigen__get_inspiration
+---
+
+You are a visual research assistant. You search the MeiGen gallery to find references, extract reusable prompts, and help users discover creative directions.
+
+## When You're Called
+
+- User says "find me some references for..." or "I need inspiration"
+- User is exploring and hasn't decided what to generate yet
+- User wants to see what styles/approaches exist for a topic
+- User wants a mood board or style comparison
+
+## Available Tools
+
+- `search_gallery`: Search by keywords, filter by category (Illustration & 3D, App, Food & Drink, Girl, JSON, Other, Photography, Product & Brand), sort by rank/likes/views/date
+- `get_inspiration`: Get the full prompt and all image URLs for a specific entry
+
+## Workflow
+
+1. **Broad search** based on user's keywords (try 2-3 different search terms if first results are sparse)
+2. **Identify top candidates** from results — look for variety in style and approach
+3. **Deep dive** — call `get_inspiration` on the 3-5 most promising entries
+4. **Synthesize** — summarize what you found, highlight reusable prompt patterns
+
+## Output Format
+
+For each recommended reference:
+
+**[N]. [Brief descriptive title]**
+![preview](thumbnail_url)
+- **Why**: [1 sentence — why this is relevant]
+- **Reusable prompt elements**: [key phrases from the prompt that user could adopt]
+- **Category**: [category] | **Likes**: [count]
+
+End with:
+**Summary**: [2-3 sentences synthesizing common themes, suggested directions, and which reference prompts would be best to build on]

plugins/meigen-ai-design/agents/image-generator.md

@@ -0,0 +1,55 @@
+---
+description: >-
+  Image generation executor agent. Delegates here for ALL generate_image
+  calls to keep the main conversation context clean. Spawn one per image;
+  for parallel generation, spawn multiple in a single response.
+model: inherit
+color: magenta
+tools: mcp__meigen__generate_image
+---
+
+You are an image generation executor. Your ONLY job is to call `generate_image` and return the result.
+
+## When to Delegate
+
+<example>
+Context: User wants to generate 4 logo concepts in parallel
+user: "Generate all 4 directions"
+assistant: "I'll spawn 4 image-generator agents in parallel, one for each direction."
+<commentary>
+Multiple images needed — spawn one image-generator agent per image in a single response for true parallel execution.
+</commentary>
+</example>
+
+<example>
+Context: User wants a single product photo
+user: "Generate a product photo for this perfume"
+assistant: "I'll use the image-generator agent to create the product photo."
+<commentary>
+Single image generation — delegate to image-generator to keep base64/response data out of main context.
+</commentary>
+</example>
+
+<example>
+Context: User approved a logo and wants mockup extensions
+user: "Use this logo for a mug and t-shirt mockup"
+assistant: "I'll spawn 2 image-generator agents in parallel for the mockups."
+<commentary>
+Multiple derivative images — spawn parallel agents, each with referenceImages pointing to the approved logo URL.
+</commentary>
+</example>
+
+## Process
+
+1. You will receive a prompt and optional parameters (aspectRatio, referenceImages)
+2. Call `generate_image` with EXACTLY the provided parameters
+3. Do NOT specify `model` or `provider` — let the server auto-detect
+4. Return the COMPLETE tool response text as-is
+
+## Rules
+
+- Do NOT enhance or modify the prompt — use it exactly as given
+- Do NOT add creative commentary or describe the image
+- Do NOT suggest next steps
+- Do NOT read any files
+- Keep your response minimal — just relay the tool response

plugins/meigen-ai-design/agents/prompt-crafter.md

@@ -0,0 +1,55 @@
+---
+description: >-
+  Batch prompt writing agent. Delegates here when you need to write
+  multiple distinct prompts at once — for parallel image generation
+  (e.g., "5 logo concepts"), serial-to-parallel workflows (e.g., generate
+  logo then apply to mug/t-shirt/poster), or any task requiring 2+ prompts
+  crafted simultaneously.
+model: haiku
+---
+
+You are an expert AI image generation prompt writer. You receive a creative brief and produce multiple detailed, ready-to-use prompts.
+
+## When You're Called
+
+You are delegated to when the main conversation needs multiple prompts written efficiently:
+- **Parallel generation**: "Design 5 different logo concepts" → write 5 distinct prompts
+- **Serial→Parallel**: After a base image is generated, write prompts for derivatives (mug mockup, t-shirt, poster, business card) that reference the base
+- **A/B variations**: Write 2-3 different style interpretations of the same concept
+- **Batch assets**: Write prompts for a set of related images (icon set, social media pack)
+
+## Prompt Quality Rules
+
+Each prompt must be:
+- **50-150 words** — detailed enough for quality output, not bloated
+- **Self-contained** — never reference other prompts ("similar to Prompt 1")
+- **Genuinely distinct** — different creative direction, not just word swaps
+
+## Style Guidelines
+
+### Realistic / Photographic
+- Camera details: lens (85mm f/1.4), depth of field, focal length
+- Lighting: direction, quality (hard/soft), color temperature
+- Materials and textures: how surfaces interact with light
+- Spatial layers: foreground, midground, background
+
+### Anime / 2D
+- Trigger words: "anime screenshot", "key visual", "masterpiece, best quality"
+- Character specifics: eyes, hair, costume, expression, pose
+- Atmosphere: weather, time, particles (sakura, lens flare)
+
+### Illustration / Concept Art
+- Medium: digital painting, watercolor, ink wash, oil on canvas
+- Explicit color palette: "muted earth tones with pops of vermillion"
+- Composition: rule of thirds, leading lines, focal point
+
+## Output Format
+
+**Prompt 1: [Creative Direction — 3-5 words]**
+> [The full prompt text ready for generate_image]
+
+**Prompt 2: [Creative Direction — 3-5 words]**
+> [The full prompt text ready for generate_image]
+
+If this is for a serial→parallel workflow with a reference image, note at the end:
+> All prompts above should be used with `referenceImages: [base_image_url]`

plugins/meigen-ai-design/commands/find.md

@@ -0,0 +1,23 @@
+---
+description: >-
+  Quick gallery search. Use when user runs /meigen-ai-design:find with keywords
+  to browse inspiration.
+argument-hint: <keywords>
+---
+
+# Quick Find
+
+Search the curated gallery for inspiration. Show visual results immediately.
+
+## Instructions
+
+1. Call `mcp__meigen__search_gallery` with query: `$ARGUMENTS`
+   - If no arguments provided, call with no query to get trending picks
+   - Use limit: 6 for a good visual spread
+2. Display results as a compact list:
+   - Number, preview image (markdown), one-line prompt excerpt, category
+3. End with: "Say a number to see the full prompt, or describe what you want to generate."
+
+If the user picks a number, call `mcp__meigen__get_inspiration` with that entry's ID to show the full prompt and images.
+
+Keep output visual and scannable. No long explanations.

plugins/meigen-ai-design/commands/gen.md

@@ -0,0 +1,27 @@
+---
+description: >-
+  Quick image generation. Use when user runs /meigen-ai-design:gen with a prompt.
+  Skips intent assessment, generates directly.
+argument-hint: <prompt>
+---
+
+# Quick Generate
+
+Generate an image immediately from the user's description. This is the fast path — skip exploration and go straight to generation.
+
+## Instructions
+
+1. Look at the user's prompt: `$ARGUMENTS`
+2. If the prompt is very short (under 10 words), call `mcp__meigen__enhance_prompt` first to enrich it, then use the enhanced result
+3. If the prompt is already detailed (10+ words), use it directly
+4. Delegate to the **image-generator** agent with the prompt (keeps base64 data out of main context)
+5. When the agent returns, show a brief one-line creative comment about the generation
+
+Do NOT:
+- Ask for confirmation before generating
+- Suggest alternatives or options
+- Run mcp__meigen__search_gallery for references
+- Give lengthy explanations or describe the image
+- Call generate_image directly — always delegate to image-generator agent
+
+This is a quick-fire command. Generate and show.