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

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

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

访问 duojie.games 获取你的 API Key（格式：sk-xxxxx）

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

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

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

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

提示词结构公式：

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

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

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

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

提示词对比：

❌ 差的提示词：一个傀儡图标

• 太简单，风格不明确
• 缺少质感描述
• 没有技术要求

✅ 好的提示词：国产仙侠游戏图标，古朴木质令牌，金色毛笔字“傀儡”，立体质感，3D渲染，高品质UI

• 风格明确（国产仙侠）
• 材质清晰（木质、金色）
• 技术要求（3D渲染、高品质）

提供一张或多张参考图，AI 会学习其风格、构图或元素，生成相似风格的新图像。适合：

• 保持系列图标风格统一
• 基于现有设计生成变体
• 风格迁移

使用参考图时，提示词应该：

• 明确说明保留什么（风格、配色、构图）
• 明确说明改变什么（主体、细节、元素）
• 避免与参考图冲突的描述

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

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

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

关键点：

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

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

常用组合：

• 游戏图标：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)：纵向构图，适合人物立绘

方形图标 (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"

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

常用负面提示词分类：

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

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

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

效果对比：

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

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

通过微调提示词生成变体：

• 改变配色：红色 → 蓝色 → 金色
• 改变材质：木质 → 金属 → 玉石
• 改变角度：正面 → 侧面 → 俯视
• 改变氛围：明亮 → 阴暗 → 神秘

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

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

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

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

批量生成技巧：

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

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

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

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

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

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