# Kokon

> Kokon is an open-source MCP server for design and media. Offline image generation and editing with Qwen-Image on your own GPU via Kokon. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, self-hosted, CLI
- **Website:** https://kokon.app
- **Repository:** https://github.com/gabrielelozupone/kokon/tree/HEAD/mcp
- **MCP Registry name:** io.github.GabrieleLozupone/kokon
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add kokon -- npx -y kokon-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/kokon
