kie-image-mcp

KIE.ai の画像生成 MCP。KIE.ai 上の任意の画像生成モデル（google/nano-banana 系、GPT Image 2 系など）を model 引数または環境変数で指定できる。省略時の既定値のみ gpt-image-2-text-to-image / gpt-image-2-image-to-image。

Features

• kie_create_task / kie_check_task - 非同期の単体画像生成
• kie_create_tasks / kie_check_tasks - 非同期の並列画像生成
• kie_upload_file - ローカル参照画像を KIE.ai にアップロードし、image_input 用の URL を取得

Setup

npm install
cp .env.example .env
# Set KIE_AI_API_KEY in .env
npm run build

Usage with Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "kie-image": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/kie-image-mcp/dist/index.js"]
    }
  }
}

Environment Variables

Variable	Required	Description
KIE_AI_API_KEY	Yes	KIE.ai API key
KIE_IMAGE_TEXT_TO_IMAGE_MODEL	No	image_input なしの既定モデル。未指定時は gpt-image-2-text-to-image
KIE_IMAGE_IMAGE_TO_IMAGE_MODEL	No	image_input ありの既定モデル。未指定時は gpt-image-2-image-to-image
KIE_IMAGE_MODEL	No	text-to-image 側の一括上書き。KIE_IMAGE_TEXT_TO_IMAGE_MODEL がある場合はそちらを優先
KIE_IMAGE_RESOLUTION	No	既定解像度。1K / 2K / 4K、未指定時は 1K
IMAGE_OUTPUT_DIR	No	Output directory (default: ./output)

モデル切替

kie_create_task / kie_create_tasks は model 引数に KIE.ai の任意のモデル ID（例: google/nano-banana）を受け取る。省略時は以下で自動選択する。

入力	既定モデル
image_input なし	gpt-image-2-text-to-image
image_input あり	gpt-image-2-image-to-image

モデルによって送信ペイロードを切り替える:

• GPT Image 2 系（モデル ID が gpt-image-2 で始まる）: image_input を KIE.ai API の input_urls に変換して送る。text-to-image 系モデルに image_input を渡すとエラーにする。
• それ以外（nano-banana 等）: image_input + output_format: png の形状で送る。