mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
2566f79d5c
- 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>
113 lines
3.5 KiB
Markdown
113 lines
3.5 KiB
Markdown
# 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
|