<h1 align="center">
  MeiGen AI Design MCP <a href="https://github.com/SamurAIGPT/awesome-openclaw"><img src="https://img.shields.io/badge/Awesome-OpenClaw-fc60a8?style=flat-square&logo=awesomelists&logoColor=white" alt="Awesome OpenClaw"></a>
</h1>

<p align="center">
  <strong>让 Claude Code / OpenClaw 变成媲美 Lovart 的私人设计助理</strong><br><sub>支持本地 ComfyUI 生图和接入 API，1,300+ 专业提示词库，多方案并行</sub>
</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://mcp-cn.com"><img src="https://img.shields.io/badge/MCP_Hub-China-red?style=flat-square" alt="MCP Hub China"></a>
</p>

<p align="center">
  <a href="#快速开始">快速开始</a> &bull;
  <a href="#实际效果">演示</a> &bull;
  <a href="#功能一览">功能</a> &bull;
  <a href="#生成后端">后端</a> &bull;
  <a href="#快捷命令">命令</a>
</p>

<p align="center">
  <a href="README.md">English</a> | <strong>中文</strong>
</p>

---

## 这是什么？

一个开源 MCP Server（通过插件市场安装），通过 8 个 tools 和精心设计的 skills，让 LLM 具备创意和审美能力，可以完成更复杂的设计任务。它能让 LLM 了解各种生图模型的使用技巧，通过参考图和多方案并行，交付更专业的成果。

- 可以调用本地 ComfyUI 服务，不依赖外部 API；也可以方便地接入任意自定义 API
- 内置 1,300+ 优质提示词模板和精心调试的提示词撰写技巧，把需求转化为具象的生图任务
- 支持并行批量任务和子 Agent 调用，避免主窗口上下文膨胀

---

## 实际效果

<p align="center">
  <a href="https://youtu.be/JQ3DZ1DXqvs">
    <img src="https://img.youtube.com/vi/JQ3DZ1DXqvs/maxresdefault.jpg" alt="观看演示" width="400">
  </a>
  <br>
  <b><a href="https://youtu.be/JQ3DZ1DXqvs">▶ 在 YouTube 观看演示</a></b>
</p>

### 产品图 — 4 个方向并行生成

> *"帮这瓶香水做 4 张产品展示图，其中一张要有模特。"*

**过程** — AI 自动上传参考图、规划 4 个创意方向、撰写专业提示词：

<p align="center">
  <img src="assets/demo-process-zh.jpg" alt="并行生成过程" width="700">
</p>

**结果** — 不到 2 分钟，4 个方向全部完成：

<p align="center">
  <img src="assets/demo-result-zh.jpg" alt="生成结果" width="700">
</p>

**生成的图片：**

<p align="center">
  <img src="assets/sample-luxury.jpg" alt="奢华静物" width="24%">
  <img src="assets/sample-model.jpg" alt="优雅模特" width="24%">
  <img src="assets/sample-botanicals.jpg" alt="梦幻花境" width="24%">
  <img src="assets/sample-minimal.jpg" alt="极简光影" width="24%">
</p>

---

## 快速开始

### Claude Code 插件（推荐）

```bash
# 添加插件源
/plugin marketplace add jau123/MeiGen-AI-Design-MCP

# 安装
/plugin install meigen@meigen-marketplace
```

**安装完成后重启 Claude Code**（关闭再打开，或新建终端标签页）。

#### 首次配置

重启后，免费功能无需配置即可使用 — 试试问：

> "帮我搜索一些创意灵感"

如需解锁图片生成，运行配置向导：

```
/meigen:setup
```

向导会引导你完成：
1. **选择后端** — 本地 ComfyUI、MeiGen 云端、或 OpenAI 兼容 API
2. **输入凭证** — ComfyUI 地址、API Token 或 Key
3. **完成** — 再次重启 Claude Code，即可开始生图

### Cursor / VS Code / Windsurf / Roo Code

一行命令为任意支持的 AI 编程工具配置 MeiGen：

```bash
npx meigen init cursor      # Cursor
npx meigen init vscode      # VS Code / GitHub Copilot
npx meigen init windsurf    # Windsurf
npx meigen init roo         # Roo Code
npx meigen init claude      # Claude Code（项目级）
```

自动写入正确格式的 MCP 配置文件。如果配置文件已存在，MeiGen 会合并写入，不会覆盖你的其他 MCP 服务。

### OpenClaw

我们的技能遵循 [Agent Skills](https://agentskills.io) 开放标准，可直接复制到 OpenClaw 工作区使用。如需 MCP 工具，通过 OpenClaw 的 MCP adapter 连接 MeiGen server 即可。

### 其他 MCP 兼容客户端

添加到 MCP 配置文件（如 `.mcp.json`、`claude_desktop_config.json`）：

```json
{
  "mcpServers": {
    "meigen": {
      "command": "npx",
      "args": ["-y", "meigen@latest"],
      "env": {
        "MEIGEN_API_TOKEN": "meigen_sk_..."
      }
    }
  }
}
```

> 即使没有 API Key，免费功能（灵感搜索、提示词增强、模型列表）也可以直接使用。

---

<h2 id="功能一览">功能一览</h2>

### MCP 工具

| 工具 | 免费 | 说明 |
|------|------|------|
| `search_gallery` | 是 | 搜索 1,300+ 精选热门提示词，附带视觉预览 |
| `get_inspiration` | 是 | 获取某条提示词的完整内容、所有图片和元数据 |
| `enhance_prompt` | 是 | 将简短想法转化为专业图片提示词 |
| `list_models` | 是 | 列出所有已配置后端的可用模型 |
| `upload_reference_image` | 是 | 压缩并上传本地图片，用作参考图 |
| `comfyui_workflow` | 是 | 管理 ComfyUI 工作流模板：列表、查看、导入、修改、删除 |
| `manage_preferences` | 是 | 记住你偏好的风格、比例、模型和收藏的提示词 |
| `generate_image` | 需要 Key | 生成图片 — 自动路由到最佳可用后端 |

### 快捷命令

| 命令 | 说明 |
|------|------|
| `/meigen:gen <提示词>` | 快速生图 — 跳过对话，直接生成 |
| `/meigen:find <关键词>` | 搜索 1,300+ 精选提示词获取灵感 |
| `/meigen:models` | 浏览和切换当前会话的 AI 模型 |
| `/meigen:ref <文件路径>` | 上传本地图片作为参考图，返回 URL |
| `/meigen:setup` | 交互式后端配置向导 |

### 智能 Agent

MeiGen 使用专用子 Agent 实现高效并行执行：

| Agent | 用途 |
|-------|------|
| `image-generator` | 在隔离上下文中执行 `generate_image` — 支持真正的并行生成 |
| `prompt-crafter` | 为批量生成撰写多个不同风格的提示词（使用 Haiku 模型，更节省成本） |
| `gallery-researcher` | 深度灵感搜索，不会占用主对话的上下文（使用 Haiku 模型） |

### 输出风格

通过 `/output-style` 切换创意模式：

- **Creative Director** — 创意总监模式，以视觉叙事、情绪板和设计思维组织回复
- **Minimal** — 极简模式，只输出图片和文件路径，无多余解释。适合批量工作流

### 自动化 Hook

- **配置检查** — 会话启动时自动验证后端配置，缺失时引导完成设置
- **自动打开** — 生成的图片自动在预览中打开（macOS）

---

<h2 id="生成后端">生成后端</h2>

MeiGen MCP 支持三种图片生成后端，可以配置一个或多个 — 系统自动选择最佳可用后端。

### ComfyUI — 本地免费

在自己的 GPU 上运行，完全控制模型、采样器和工作流参数。支持导入任意 ComfyUI API 格式的工作流 — MeiGen 自动检测 KSampler、CLIPTextEncode、EmptyLatentImage、LoadImage 节点。

```json
{
  "comfyuiUrl": "http://localhost:8188",
  "comfyuiDefaultWorkflow": "txt2img"
}
```

> 适合 Flux、SDXL 或任何你本地运行的模型。图片完全不离开你的机器。

### MeiGen 云端

云端 API，支持多种模型：Nanobanana Pro、GPT image 1.5、Seedream 4.5 等。无需 GPU。

**获取 API Token：**
1. 登录 [meigen.ai](https://www.meigen.ai)
2. 点击头像 → **设置** → **API Keys**
3. 创建新 Key（以 `meigen_sk_` 开头）

```json
{ "meigenApiToken": "meigen_sk_..." }
```

### OpenAI 兼容 API

使用你自己的 API Key 接入 OpenAI（gpt-image-1.5）、Together AI、Fireworks AI 或任何兼容服务。

```json
{
  "openaiApiKey": "sk-...",
  "openaiBaseUrl": "https://api.openai.com",
  "openaiModel": "gpt-image-1.5"
}
```

> 三种后端都支持**参考图**。MeiGen 和 OpenAI 直接接受 URL；ComfyUI 会将参考图注入到工作流的 LoadImage 节点中。

---

## 配置

### 交互式配置（推荐）

```
/meigen:setup
```

配置向导会引导你选择后端、输入 API Key、导入 ComfyUI 工作流。你也可以直接粘贴 API 提供商文档中的 `curl` 命令 — 自动提取 Key、URL 和模型名。

### 配置文件

配置存储在 `~/.config/meigen/config.json`。ComfyUI 工作流存储在 `~/.config/meigen/workflows/`。

### 环境变量

环境变量优先级高于配置文件。

| 变量 | 说明 |
|------|------|
| `MEIGEN_API_TOKEN` | MeiGen 平台 Token |
| `OPENAI_API_KEY` | OpenAI / 兼容 API Key |
| `OPENAI_BASE_URL` | API 地址（默认：`https://api.openai.com`） |
| `OPENAI_MODEL` | 默认模型（默认：`gpt-image-1.5`） |
| `COMFYUI_URL` | ComfyUI 服务地址（默认：`http://localhost:8188`） |

---

## 隐私

MeiGen MCP 尊重你的隐私。以下是数据处理方式：

- **ComfyUI（本地）** — 所有处理在本机完成，不发送任何数据到外部。
- **MeiGen 云端** — 提示词和参考图会发送到 `api.meigen.ai` 进行生成。生成的图片临时存储在 Cloudflare R2。详见 [meigen.ai/privacy](https://www.meigen.ai/privacy)。
- **OpenAI 兼容 API** — 提示词和参考图会发送到你配置的 API 端点。请参考你的服务商隐私政策。
- **参考图上传** — 图片在本地压缩（最大 2MB）后上传到 Cloudflare R2（通过 `gen.meigen.ai`），无需认证。
- **灵感搜索和提示词增强** — 在本地使用内置数据运行，不调用外部 API。

不包含任何遥测、分析或追踪功能。

---

## 许可证

[MIT](LICENSE) — 个人和商业用途均免费。
