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 424 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
MCP Local RAG
shinpr/mcp-local-rag
Easy-to-setup local RAG server with minimal configuration.
Active · last commit Nov 13, 2026
AI & searchTypeScriptMCP Server Odoo
ivnvxd/mcp-server-odoo
Model Context Protocol (MCP) server that enables AI assistants to securely interact with Odoo ERP systems through standardized resources and tools for data retrieval and manipulation.
Active · last commit Oct 10, 2026
AI & searchPythonMarm MCP Server
Lyellr88/marm-memory
Universal MCP Server with advanced AI memory capabilities and semantic search.
Active · last commit Oct 23, 2026
AI & searchPythonPageIndex MCP
VectifyAI/pageindex-mcp
Reasoning-based RAG system for chatting with long PDFs.
Active · last commit Nov 3, 2026
AI & searchTypeScriptContext
neuledge/context
Local-first documentation for AI agents. Offline, instant, private doc retrieval.
Maintained · last commit Nov 16, 2026
OfficialAI & searchTypeScriptNanobanana MCP Server
zhongweili/nanobanana-mcp-server
An MCP server that provides image generation and editing capabilities.
Active · last commit Oct 2, 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 Nov 11, 2026. The latest release is v0.12.1, published Nov 11, 2026. appsgit only lists MCP servers with a commit in the last six months.