Kokon
Offline image generation and editing with Qwen-Image on your own GPU via Kokon
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"kokon": {
"command": "npx",
"args": [
"-y",
"kokon-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kokon": {
"command": "npx",
"args": [
"-y",
"kokon-mcp"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP 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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media