Files
agents/plugins/meigen-ai-design
jau123 2566f79d5c Address review feedback: restructure plugin for marketplace conventions
- Remove .mcp.json (not used in marketplace, add README instead)
- Add marketplace.json entry for plugin discovery
- Add README.md with MCP server setup guide, provider config, and troubleshooting
- Add tools: declaration to image-generator agent (functional fix)
- Move <example> blocks from YAML frontmatter to markdown body
- Remove unused tools: Read, Grep, Glob from prompt-crafter agent
- Remove redundant name: field from command frontmatter
- Use full MCP tool prefix (mcp__meigen__*) in commands
- Rewrite plugin.json description to factual style
- Pin npm version to meigen@1.2.5

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 01:49:29 +08:00
..

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:

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

  1. Sign up at meigen.ai
  2. Click avatar → Settings → API Keys → create a new key (starts with meigen_sk_)
  3. Set environment variable:
export MEIGEN_API_TOKEN=meigen_sk_your_token_here

Option B: Local ComfyUI (Free, Private)

  1. Install and run ComfyUI
  2. Set environment variable:
export COMFYUI_URL=http://localhost:8188
  1. 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.):

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

License

MIT