====== mcp-duojie-image 配置与使用说明 ======

===== 简介 =====

''mcp-duojie-image'' 是一个基于 MCP (Model Context Protocol) 的图像生成服务器，通过 duojie.games API 调用 Gemini 3.1 Flash Image 模型生成图片。

===== 功能特性 =====

  * 文本生成图像（Text-to-Image）
  * 参考图像生成（Image-to-Image）
  * 自动文件保存，支持重名冲突处理
  * 可配置输出格式和尺寸
  * 支持负面提示词

===== 安装配置 =====

==== 1. 获取 API Key ====

访问 [[https://duojie.games|duojie.games]] 获取你的 API Key（格式：''sk-xxxxx''）

==== 2. 配置 MCP 客户端 ====

=== Cline / Claude Desktop ===

在项目的 ''.factory/mcp.json'' 或全局 MCP 配置文件中添加：

<code json>
{
  "mcpServers": {
    "duojie-image": {
      "command": "npx",
      "args": ["-y", "mcp-duojie-image"],
      "env": {
        "DUOJIE_API_KEY": "sk-your-key-here"
      }
    }
  }
}
</code>

==== 3. 重启 MCP 客户端 ====

配置完成后，需要重启 Cline 或 Claude Desktop 以加载 MCP 服务器。

===== 使用示例 =====

==== 功能场景速查表 ====

^ 功能特性 ^ 对应参数 ^ 典型应用 ^
| 纯文本生成 | ''prompt'' | 从零创作，快速出图 |
| 参考图生成（垫图） | ''reference_images'' | 风格迁移、变体创作 |
| 尺寸控制 | ''size'', ''aspect_ratio'' | 不同平台规格适配 |
| 负面提示词 | ''negative_prompt'' | 排除不想要的元素 |
| 批量生成 | ''overwrite=false'' | 同主题多方案对比 |

==== 场景一：纯文本生成图像 ====

=== 功能说明 ===

最基础的使用方式，只需要描述你想要的画面，AI 会从零开始创作。

=== 提示词技巧 ===

**提示词结构公式：**

''[风格定位] + [主体描述] + [细节补充] + [质量/技术词]''

  * **风格定位**：国产仙侠、赛博朋克、写实、卡通、像素风等
  * **主体描述**：核心内容是什么（人物、物品、场景）
  * **细节补充**：材质、颜色、光影、构图、角度
  * **质量词**：高品质、精致、3D渲染、游戏UI风格等

=== 示例：游戏道具图标 ===

<code>
生成一张傀儡凭证图标，要求：
- 对话：生成一张图标，纯色背景，仙侠风格，游戏图标，月卡道具，
        是个傀儡的使用凭证，凭证上面写着"傀儡"2字，毛笔字，
        1:1比例，保存到 D:\icons 目录，文件名：傀儡

AI 会调用工具：
  prompt: "国产仙侠游戏图标，月卡道具，古朴的木质令牌斜着放置，
           纯色背景，令牌表面有纹理和磨损感，中央用金色毛笔字写着
           "傀儡"两个大字，笔触苍劲有力，字体有立体感和金属光泽，
           令牌边缘有精致的雕花纹饰，整体色调古雅神秘，写实质感，
           3D渲染风格，高品质游戏UI图标"
  output_dir: "D:\\icons"
  output_filename: "傀儡"
  size: "1K"
  aspect_ratio: "1:1"
</code>

**提示词对比：**

❌ **差的提示词**：''一个傀儡图标''
  * 太简单，风格不明确
  * 缺少质感描述
  * 没有技术要求

✅ **好的提示词**：''国产仙侠游戏图标，古朴木质令牌，金色毛笔字"傀儡"，立体质感，3D渲染，高品质UI''
  * 风格明确（国产仙侠）
  * 材质清晰（木质、金色）
  * 技术要求（3D渲染、高品质）

==== 场景二：使用参考图生成（垫图） ====

=== 功能说明 ===

提供一张或多张参考图，AI 会学习其风格、构图或元素，生成相似风格的新图像。适合：
  * 保持系列图标风格统一
  * 基于现有设计生成变体
  * 风格迁移

=== 提示词技巧 ===

使用参考图时，提示词应该：
  * 明确说明**保留什么**（风格、配色、构图）
  * 明确说明**改变什么**（主体、细节、元素）
  * 避免与参考图冲突的描述

=== 示例：生成同系列图标 ===

<code>
已有一张"剑"图标，想生成同风格的"盾"图标：

对话：参考 D:\icons\剑.png 的风格，生成一个盾牌图标，
      保持相同的配色和质感，保存为"盾"

AI 会调用工具：
  prompt: "游戏道具图标，盾牌，保持参考图的风格、配色和质感，
           同样的光影效果和边框装饰"
  reference_images: ["D:\\icons\\剑.png"]
  output_dir: "D:\\icons"
  output_filename: "盾"
  size: "1K"
  aspect_ratio: "1:1"
</code>

**关键点：**
  * 提示词要说明"保持参考图的风格"
  * 只描述**不同的部分**（主体从剑变成盾）
  * 参考图路径必须是**绝对路径**

==== 场景三：控制输出尺寸 ====

=== 功能说明 ===

通过 ''size'' 和 ''aspect_ratio'' 参数控制图像尺寸和比例，适配不同平台需求。

=== 参数说明 ===

^ 参数 ^ 可选值 ^ 说明 ^
| ''size'' | ''512px'', ''1K'', ''2K'', ''4K'' | 图像分辨率 |
| ''aspect_ratio'' | ''1:1'', ''16:9'', ''9:16'', ''4:3'' 等 | 宽高比 |

**常用组合：**
  * 游戏图标：''size: "1K", aspect_ratio: "1:1"''
  * 横版 Banner：''size: "2K", aspect_ratio: "16:9"''
  * 竖版海报：''size: "2K", aspect_ratio: "9:16"''
  * 概念图：''size: "2K", aspect_ratio: "16:9"''

=== 提示词技巧 ===

不同比例需要调整构图描述：
  * **方形 (1:1)**：居中构图，主体完整
  * **横版 (16:9)**：横向延展，适合场景、全景
  * **竖版 (9:16)**：纵向构图，适合人物立绘

=== 示例：不同比例的场景图 ===

<code>
方形图标 (1:1)：
  prompt: "森林场景，居中构图，一棵古树占据画面中心"
  size: "1K"
  aspect_ratio: "1:1"

横版场景 (16:9)：
  prompt: "森林场景，横向全景，左侧古树，右侧延伸到远方的小径"
  size: "2K"
  aspect_ratio: "16:9"

竖版场景 (9:16)：
  prompt: "森林场景，仰视角度，古树从下往上延伸，树冠在画面顶部"
  size: "2K"
  aspect_ratio: "9:16"
</code>

==== 场景四：使用负面提示词 ====

=== 功能说明 ===

''negative_prompt'' 用于排除不想要的元素、风格或效果，提高生成质量。

=== 提示词技巧 ===

**常用负面提示词分类：**

^ 类别 ^ 常用词汇 ^
| 风格排除 | 扁平风格, 卡通风格, 简约风格, 像素风 |
| 效果排除 | 外发光, 光晕, 模糊, 噪点, 水印 |
| 元素排除 | 多余文字, 人物, 背景杂乱, 边框 |
| 质量排除 | 低质量, 变形, 比例失调, 色彩过饱和 |

=== 示例：精确控制图标风格 ===

<code>
需求：生成写实质感的仙侠图标，避免扁平化和外发光

对话：生成一个仙侠风格的令牌图标，要有立体质感，
      不要扁平风格，不要外发光效果

AI 会调用工具：
  prompt: "国产仙侠游戏图标，古朴令牌，写实质感，3D渲染，
           立体光影，金属和木质纹理"
  negative_prompt: "扁平风格, 卡通风格, 外发光, 光晕, 简约风格,
                    2D平面, 无质感"
  output_dir: "D:\\icons"
  output_filename: "令牌"
  size: "1K"
  aspect_ratio: "1:1"
</code>

**效果对比：**

❌ **不使用负面提示词**：可能生成扁平化图标，带有外发光效果
✅ **使用负面提示词**：确保生成立体质感，无多余光效

==== 场景五：批量生成多方案 ====

=== 功能说明 ===

设置 ''overwrite: false''（默认值），重复生成时自动添加数字后缀，方便对比多个方案。

=== 提示词技巧 ===

通过**微调提示词**生成变体：
  * 改变配色：红色 → 蓝色 → 金色
  * 改变材质：木质 → 金属 → 玉石
  * 改变角度：正面 → 侧面 → 俯视
  * 改变氛围：明亮 → 阴暗 → 神秘

=== 示例：生成3种配色方案 ===

<code>
需求：同一个宝剑图标，生成红、蓝、金三种配色

第一次生成（红色）：
  prompt: "游戏武器图标，宝剑，红色剑身，火焰纹饰"
  output_filename: "宝剑"
  overwrite: false
  → 保存为：宝剑.png

第二次生成（蓝色）：
  prompt: "游戏武器图标，宝剑，蓝色剑身，冰霜纹饰"
  output_filename: "宝剑"
  overwrite: false
  → 保存为：宝剑_1.png

第三次生成（金色）：
  prompt: "游戏武器图标，宝剑，金色剑身，雷电纹饰"
  output_filename: "宝剑"
  overwrite: false
  → 保存为：宝剑_2.png
</code>

**批量生成技巧：**
  * 保持**主体和构图**不变
  * 只改变**一个维度**（配色/材质/角度）
  * 使用 ''overwrite: false'' 自动编号
  * 最后对比选择最佳方案

==== 综合示例：完整工作流 ====

<code>
任务：为仙侠游戏设计一套月卡道具图标

步骤1：生成第一个图标（建立风格基准）
  对话：生成一个仙侠风格的"傀儡令"图标，木质令牌，
        金色毛笔字，立体质感，1:1，保存到 D:\月卡图标

步骤2：基于第一个图标生成同系列（保持风格统一）
  对话：参考"傀儡令"的风格，生成"灵兽符"图标，
        保持相同质感和配色

步骤3：批量生成变体（探索不同方案）
  对话：再生成2个"灵兽符"的变体，一个偏蓝色调，
        一个偏紫色调

步骤4：调整细节（使用负面提示词优化）
  对话：重新生成"灵兽符"，去掉外发光效果，
        增强木质纹理
</code>