Skip to content
appsgit

Kokon

Kokon is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Generate and edit images offline with Qwen-Image 2.1 on your GPU. It has 220 GitHub stars, is released under the AGPL-3.0 license and runs locally with npx -y kokon-mcp.

github.com/GabrieleLozupone/kokon (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

Install Kokon

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "kokon": {
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ],
      "env": {
        "QLS_MCP_ALLOWED_DIRS": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env QLS_MCP_ALLOWED_DIRS=your-value --transport stdio kokon -- npx -y kokon-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "kokon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ],
      "env": {
        "QLS_MCP_ALLOWED_DIRS": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "kokon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kokon-mcp"
      ],
      "env": {
        "QLS_MCP_ALLOWED_DIRS": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

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

Tools (8)

Parsed from the Tools section of the README; check the repository for the current list.

  • generate_image

    Text to image, optionally with up to 10 reference images (a person, a product, a style) in a new scene.

  • edit_image

    Edit an image with an instruction. Keeps its size; never overwrites the input.

  • edit_images

    Edit image 1 with the help of up to 9 more images ("image 1", "image 2"...).

  • inpaint_image

    Change only a masked area: edit, remove, replace or add something.

  • 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, the prompt, seed and settings.

  • get_generator_status

    Engine state, GPU, VRAM and job queue.

About Kokon

MCP server for Kokon. It lets Claude Code, Cursor, Claude Desktop and other MCP clients generate and edit images with Qwen-Image 2.1, running offline on your own GPU. No API key, no cloud. Everything stays on 127.0.0.1.

  • image-editing
  • image-generation
  • local-ai
  • macos
  • mcp
  • mcp-server
  • offline
  • privacy
  • qwen-image
  • qwen-image-2-1

FAQ

Kokon FAQ

Still curious? Email info@appsgit.com.

How do I install the Kokon MCP server?

Add the command npx -y kokon-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Kokon free?

The server is open source under the AGPL-3.0 license, so running it is free. It does not declare any required API key.

Is Kokon actively maintained?

The most recent commit was on Oct 24, 2026. The latest release is v0.11.0, published Oct 24, 2026. appsgit only lists MCP servers with a commit in the last six months.