Skip to content
MCP server

Kokon

Offline image generation and editing with Qwen-Image on your own GPU via Kokon

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
0.12.1
Listing updated
3 days ago

About Kokon

Kokon is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Kokon is a desktop app that runs an image model on your own graphics card, and this MCP server lets an assistant drive it. Prompts are written in full by the assistant, because Kokon's own prompt helper does not run for MCP. The desktop app must be installed first.

The tool set covers text-to-image with up to 10 reference images, instruction-based editing, masked inpainting, outpainting and upscaling up to 8192 px. Each result returns the absolute path of the saved file with its size and seed, and images are only sent back to the model as a small JPEG if you ask for a preview.

File access is fenced to the project folder, Kokon's output folder and any folders listed in QLS_MCP_ALLOWED_DIRS, and existing files are never overwritten. The server code is AGPL-3.0; the model weights are under the Qwen Research License, which is non-commercial.

Install

Run in a terminal

claude mcp add kokon -- npx -y kokon-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kokon": {
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kokon": {
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • QLS_MCP_ALLOWED_DIRSExtra folders the server may read and write, separated by semicolons. The project folder and Kokon's output folder are always allowed.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

generate_image
Text to image with up to 10 reference images.
edit_image
Edit an image with an instruction without overwriting the input.
edit_images
Edit image 1 using up to 9 more images.
inpaint_image
Change only a masked area.
outpaint_image
Extend an image beyond its borders.
upscale_image
Enlarge an image, default 2x, up to 8192 px.
get_image_info
Size, type and, for Kokon images, prompt, seed and settings.
get_generator_status
Engine state, GPU, VRAM and job queue.

What it does

Reference-guided generation
Create new scenes from up to 10 reference images.
Instruction edits
Change a photo by describing the edit, keeping its size.
Masked inpainting
Edit, remove, replace or add within a masked region.
Outpaint and upscale
Extend borders or enlarge up to 8192 px.
Folder allow-list
Reads and writes stay within the project, output and allowed folders.
Job and GPU status
Reports engine state, GPU, VRAM and queue.

Good for

  • Generate assets for a project from a coding agent
  • Remove an object from a photo without uploading it
  • Extend a banner image past its borders
  • Upscale screenshots or artwork locally

Pricing

Open source

Free and open source; model weights non-commercial

Prices change. Check kokon.app before you buy.

Kokon FAQ

Does it need the Kokon app?

Yes, the registry entry says it needs the Kokon desktop app.

Can I use results commercially?

The model weights are under the Qwen Research License, non-commercial; the site says images are for non-commercial use.

Which hardware runs it?

The site lists NVIDIA, AMD, Intel Arc and Apple Silicon on Windows, Mac and Linux.

Will it overwrite my originals?

No. Existing files are never overwritten.

Is Kokon free?

Yes. Kokon is open source, so you can use and self-host it for free.

How do I add Kokon to Claude Code?

Run this command in your terminal: claude mcp add kokon -- npx -y kokon-mcp

What are the best alternatives to Kokon?

The closest alternatives to Kokon are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Kokon

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media