Kokon

kokon-mcp

Kokon 用の MCP サーバーです。Claude Code、Cursor、Claude Desktop などの MCP クライアントから、Qwen-Image 2.1 を使って画像を生成・編集できます。処理はお使いの GPU 上でオフラインで実行されます。 API キーもクラウドも不要です。すべての処理は 127.0.0.1 上で行われます。

Kokon デスクトップアプリが必要です（Windows の場合、12 GB 以上の GPU：NVIDIA、またはベータ版の AMD／Intel。Apple Silicon Mac の場合はベータ版で、16 GB 以上）。kokon.app からダウンロードして一度起動し、セットアップを完了してモデルをダウンロードしてください。このパッケージは、AI エージェントとアプリをつなぐブリッジにすぎません。アプリを起動しておく必要はありません。サーバーが必要に応じてエンジンを起動します。

セットアップ

Claude Code：

claude mcp add --scope user kokon -- npx -y kokon-mcp

標準の JSON 設定（.mcp.json、Claude Desktop、Cursor など）を使うクライアント：

{
  "mcpServers": {
    "kokon": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "kokon-mcp"]
    }
  }
}

Node.js 22 以降が必要です。Node.js を使わない場合は、Kokon インストーラーに同じサーバーのスタンドアロン実行ファイル（アプリ内の kokon-mcp.exe ／ kokon-mcp）も含まれています。メインの READMEを参照してください。

あとは、「この README 用のヒーロー画像を生成して、docs/ に保存して」や「screenshot.png の背景にある不要なものを取り除いて」と頼むだけです。最初の呼び出しではモデルの読み込みに約 1 分かかります。

ツール

プロンプトはアシスタントが記述したとおりに使われます。Kokon 独自のプロンプトライター（Prompt+）は MCP では実行されないため、アシスタントが説明全体を記述します。ツールの説明に、その方法が記載されています。

ツール	機能
generate_image	テキストから画像を生成します。最大 10 枚の参照画像（人物、製品、スタイルなど）を指定して、新しいシーンを作成することもできます。サイズは自動で選択されますが、幅／高さまたはアスペクト比を指定することもできます。
edit_image	指示に従って画像を編集します。サイズは維持され、入力画像が上書きされることはありません。
edit_images	最大 9 枚の画像（「image 1」「image 2」など）を使って、image 1 を編集します。
inpaint_image	マスクした領域のみを変更します。編集、削除、置き換え、追加ができます。
outpaint_image	画像の境界を越えて拡張します。
upscale_image	画像を拡大します（デフォルトは 2 倍、最大 8192 px）。
get_image_info	画像のサイズ、種類、および Kokon 画像の場合はプロンプト、シード、設定を取得します。
get_generator_status	エンジンの状態、GPU、VRAM、ジョブキューを取得します。

動作と安全性

• すべての結果に、保存したファイルの絶対パス、サイズ、シード、メタデータが含まれます。
• 読み書きできるのは、プロジェクトフォルダー（CLAUDE_PROJECT_DIR または作業ディレクトリ）、Kokon の出力フォルダー、および QLS_MCP_ALLOWED_DIRS に記載されたフォルダー（セミコロン区切り）に限られます。既存のファイルが上書きされることはありません。
• デフォルトでは、画像はモデルに返送されません。小さな JPEG を含めるには、include_preview: true を指定してください。
• 進行状況は MCP の進行状況通知を通じて報告されます。

ライセンス

AGPL-3.0-only。アプリがダウンロードする Qwen-Image 2.1 のモデルウェイトは、Qwen Research License（非商用）の下で提供されています。ソース：github.com/GabrieleLozupone/kokon。