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
{
"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-mcpCursor
{
"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
{
"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.
| Name | Required | Description |
|---|---|---|
QLS_MCP_ALLOWED_DIRS | No | Extra 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_imageText to image, optionally with up to 10 reference images (a person, a product, a style) in a new scene.
edit_imageEdit an image with an instruction. Keeps its size; never overwrites the input.
edit_imagesEdit image 1 with the help of up to 9 more images ("image 1", "image 2"...).
inpaint_imageChange only a masked area: edit, remove, replace or add something.
outpaint_imageExtend an image beyond its borders.
upscale_imageEnlarge an image (default 2x, up to 8192 px).
get_image_infoSize, type and, for Kokon images, the prompt, seed and settings.
get_generator_statusEngine 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
Similar MCP servers
More ai & search MCP servers
SuperCMO
SupercmoHQ/superCMO-skills
Marketing media generation — image, video, voice — for AI agents.
Active · last commit Oct 21, 2026
AI & searchPythonClawMem
yoloshii/ClawMem
On-device memory layer for AI agents. Claude Code, OpenClaw and Hermes.
Maintained · last commit Oct 20, 2026
AI & searchTypeScriptVexor
scarletkc/vexor
A semantic search engine for files and code.
Active · last commit Oct 2, 2026
AI & searchPythonArgo
taxueseek/argo
专门为 agent 打造的开源 agent 搜索工具,具备 200+的搜索源及多语言搜索能力,覆盖中文/英文/学术/代码/购物/金融/新闻/百科。.
Active · last commit Oct 25, 2026
AI & searchPythonMCP Sap Docs
marianfoo/mcp-sap-docs
Fast MCP server for unified SAP docs search (SAPUI5, CAP, OpenUI5, wdi5) with BM25 full-text search.
Active · last commit Oct 23, 2026
AI & searchTypeScriptMengram
alibaizhanov/mengram
Long-term memory for AI agents: semantic facts, episodic events, and procedural workflows.
Active · last commit Oct 23, 2026
AI & searchPython
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.