# 克隆仓库
git clone https://github.com/tanglifu30-blip/mcp-image-generator.git
cd mcp-image-generator

# Windows
./setup.ps1

# macOS/Linux
chmod +x setup.sh
./setup.sh

cd mcp-servers/image-generator
npm install
cp .env.example .env
# 编辑.env文件,填入你的API密钥

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-key-here"
$env:OPENAI_API_BASE="https://your-api-endpoint.com"

# macOS/Linux
export OPENAI_API_KEY="sk-your-key-here"
export OPENAI_API_BASE="https://your-api-endpoint.com"

cp .env.example .env
# 编辑.env文件

{
  "key": "sk-your-key-here",
  "url": "https://your-api-endpoint.com"
}

{
  "mcpServers": {
    "image-generator": {
      "command": "node",
      "args": ["/path/to/mcp-image-generator/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-key-here",
        "OPENAI_API_BASE": "https://your-api-endpoint.com"
      }
    }
  }
}

// 在 Claude Code 中直接使用
帮我生成一张永劫无间火男的海报

// MCP 工具调用
{
  "tool": "generate_image",
  "prompt": "永劫无间火男角色海报，火焰特效",
  "model": "gpt-image-2.5-flare",
  "size": "1024x1792",
  "quality": "hd",
  "n": 1
}

{
  "tool": "edit_image",
  "image": "base64_encoded_image_or_url",
  "prompt": "将背景改成火焰场景",
  "mask": "optional_base64_mask",  // 可选：只修改透明区域
  "model": "gpt-image-2.5-flare",
  "size": "1024x1024",
  "n": 1
}

{
  "tool": "create_variation",
  "image": "base64_encoded_image_or_url",
  "model": "gpt-image-2.5-flare",
  "size": "1024x1024",
  "n": 2  // 生成 2 个变体
}

{
  "tool": "list_images",
  "tags": ["火男", "永劫无间"],  // 必须同时包含这些标签
  "keyword": "海报",            // 在 prompt 中搜索
  "month": "2026-10",          // 筛选 2026 年 10 月
  "tool": "generate_image",    // 只看文生图的结果
  "limit": 20                  // 最多返回 20 条
}

A:\Claude使用image出图\
├── index.json                    # 全局索引
├── 2026-10/                      # 按年月组织
│   ├── 火男-海报_a1b2c3.png      # 图片文件
│   ├── 火男-海报_a1b2c3.png.json # 元数据
│   ├── 小猫_d4e5f6.png
│   └── 小猫_d4e5f6.png.json
└── 2026-11/
    └── ...

{
  "tool": "generate_image",
  "model": "gpt-image-2.5-flare",
  "prompt": "永劫无间火男角色海报",
  "size": "1024x1792",
  "quality": "hd",
  "revised_prompt": "...",
  "saved_at": "2026-10-29T12:34:56.789Z",
  "local_path": "A:\\Claude使用image出图\\2026-10\\火男-海报_a1b2c3.png",
  "filename": "火男-海报_a1b2c3.png",
  "tags": ["火男", "海报", "永劫无间", "角色"]
}

# 测试 base64 图片处理
node test-b64.js

# 测试 URL 图片下载
node test-generate.js

✓ API Config loaded
✓ API call successful
✓ Got b64_json from API
✓ Decoded base64, size: 2305380 bytes
✓ Image saved to: ...
✓ File size on disk: 2305380 bytes

✅ All tests passed!