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 を取得

Related MCP server: ImaginePro MCP Server

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

モデル切替

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

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

• 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 の形状で送る。