{
  "mcpServers": {
    "imgx": {
      "command": "npx",
      "args": ["--package=imgx-mcp", "-y", "imgx-mcp"],
      "env": { "GEMINI_API_KEY": "your-key" }
    }
  }
}

{
  "mcpServers": {
    "imgx": {
      "command": "cmd",
      "args": ["/c", "npx", "--package=imgx-mcp", "-y", "imgx-mcp"],
      "env": { "GEMINI_API_KEY": "your-key" }
    }
  }
}

npx imgx-mcp config set api-key YOUR_KEY --provider gemini

「コーヒーカップの画像を生成して」

あなた: 「この記事にカバー画像が欲しい。16:9で。記事の内容に合った画像をお任せで」

AI: （記事の内容から「開発者がターミナルに向かう朝のデスク、コーヒーカップ」を判断）
    → generate_image を実行

あなた: 「いいね。もう少し暖かい色味にして」

AI: → edit_last を実行

あなた: 「よさそう。ビネット効果を軽くかけて完成にしよう」

AI: → edit_last を実行、最終画像のパスを返す

あなた: 「OGP画像を ./content/images に保存して。1200x630くらいのサイズ感で」

AI: → generate_image を output_dir="./content/images", aspect_ratio="2:3" で実行

あなた: 「テキストが目立つように背景をもう少しシンプルにして」

AI: → edit_last を実行（同じ ./content/images 内に保存される）

あなた: 「コーヒーショップの内装のイメージ画像を作って」

AI: → generate_image を実行

あなた: 「照明を暖かくして」        → edit_last（1回目）
あなた: 「窓際にお客さんを追加して」  → edit_last（2回目）
あなた: 「人物が不自然。照明を変えた状態まで戻して」

AI: → undo_edit を実行（照明変更後の状態に戻る）

あなた: 「人物の代わりに、窓の外に雨を降らせて」

AI: → edit_last を実行（undo 地点から新しい方向へ）

あなた: 「まずブログのカバー画像を作ろう。16:9で」

AI: → generate_image を実行（セッション s-aaa が作成）

あなた: 「色味を調整して」 → edit_last
あなた: 「OGP画像も必要。1200x630で、タイトルが映える構図で」

AI: → generate_image を実行（セッション s-bbb が作成）

あなた: 「OGPはこれでいい。さっきのカバー画像に戻って、もう少し明るくして」

AI: → switch_session で s-aaa に切り替え
    → edit_last を実行（カバー画像の続きから編集）

あなた: 「同じ構図で Gemini と OpenAI 両方試して比較したい」

AI: → generate_image を provider="gemini" で実行
    → generate_image を provider="openai" で実行
    → 両方の結果を提示

あなた: 「Gemini の方がいい。これをベースに調整して」

AI: → switch_session で Gemini のセッションに切り替え
    → edit_last を実行

あなた: 「アイコンのバリエーションを4パターン生成して」

AI: → generate_image を provider="openai", count=4 で実行
    （OpenAI は複数枚同時生成に対応）

あなた: 「記事のフロントマターに今のカバー画像のパスを設定して」

AI: （直前に生成した画像のパス ./content/images/s-aaa/imgx-003.png を把握している）
    → フロントマターを更新

{
  "defaults": {
    "model": "gemini-2.5-flash-image",
    "outputDir": "./assets/images",
    "aspectRatio": "16:9"
  }
}

imgx config set model gemini-2.5-flash-image    # デフォルトモデルの変更
imgx config set output-dir ./images              # 出力先の変更
imgx config set aspect-ratio 16:9                # アスペクト比の変更
imgx config list                                 # 全設定の表示
imgx config path                                 # 設定ファイルの場所

{
  "env": {
    "GEMINI_API_KEY": "your-key",
    "IMGX_MODEL": "gemini-2.5-flash-image",
    "IMGX_OUTPUT_DIR": "./generated-images"
  }
}

npm install -g imgx-mcp

# 画像生成
imgx generate -p "木製テーブルの上のコーヒーカップ、朝の光" -o output.png

# 画像編集
imgx edit -i photo.png -p "背景を夕焼けに変更" -o edited.png

# 反復編集（--last で前回の出力を入力として使用）
imgx edit -i photo.png -p "背景を暗くする"
imgx edit --last -p "暖かい照明を追加"
imgx edit --last -p "16:9 にクロップ" -o final.png

# undo / redo
imgx undo               # 直前の編集を取り消し
imgx redo               # 取り消した編集をやり直し

# 履歴管理
imgx history            # 全セッション・全エントリを一覧
imgx history switch <session-id>  # セッション切り替え
imgx history clear      # 全履歴を消去（対話的に確認）
imgx history clear --yes          # 確認なしで消去
imgx history clear --keep-files   # 画像ファイルは残して履歴のみ消去

# プロバイダ確認
imgx providers