Kokon — MCP-сервер для Claude Code: что делает и как установить
Локальная генерация и обработка картинок через Qwen-Image 2.1 на собственном видеочипе прямо из редактора. Работает без облачных API и ключей доступа.
claude mcp add --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y kokon-mcpЧто делает Kokon
Сервер связывает ИИ-агента с десктопным приложением Kokon для локальной работы с нейросетью Qwen-Image 2.1. Инструменты пакета умеют генерировать картинки по текстовому описанию, дорисовывать области через inpaint_image, расширять холст и увеличивать разрешение до 8192 px. Все запросы выполняются на локальном адресе 127.0.0.1.
Для запуска понадобится Node.js 22 или готовый бинарный файл из дистрибутива. Без установленного десктопного приложения Kokon сервер бесполезен. Сначала придётся открыть программу один раз, чтобы скачать веса модели. Компьютеру требуется не менее 12 ГБ видеопамяти на Windows или 16 ГБ общей памяти на Apple Silicon. Первая генерация займёт около минуты из-за загрузки модели в память.
Инструменты не перезаписывают существующие файлы на диске. Доступ строго ограничен текущей рабочей папкой проекта и каталогами из переменной QLS_MCP_ALLOWED_DIRS.
Какие задачи решает
- сгенерировать иллюстрацию по текстовому описанию и референсам прямо в кодовой базе
- стереть лишние детали или перерисовать фон на скриншоте через inpainting
- увеличить разрешение картинки в два раза без передачи файлов на сторонние сервисы
- проверить текущую нагрузку на видеопамять и очередь задач локального движка
Примеры запросов агенту
- Сделай главное изображение для файла
README.mdи сохрани его в папкуdocs/ - Удали лишние элементы со скриншота
screenshot.pngс помощью инструментаinpaint_image - Увеличь разрешение файла
preview.pngв два раза черезupscale_image
Как установить Kokon
Командой платформы
claude mcp add --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y kokon-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> -- npx -y kokon-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"kokon-mcp"
],
"env": {
"QLS_MCP_ALLOWED_DIRS": "<QLS_MCP_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kokon-mcp"
],
"env": {
"QLS_MCP_ALLOWED_DIRS": "<QLS_MCP_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> mcp npx -y kokon-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Kokon
Как установить Kokon в Claude Code?
Выполните команду claude mcp add kokon -- npx -y kokon-mcp. Если нужно открыть доступ к дополнительным папкам, используйте синтаксис с переменной окружения: claude mcp add --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y kokon-mcp.
Что делает сервер Kokon?
Он предоставляет вашему ассистенту функции локального создания, изменения, масштабирования и анализа картинок на базе Qwen-Image 2.1 без выхода в интернет.
Что нужно подготовить перед запуском сервера?
Требуется установить приложение Kokon с сайта разработчика, завершить первую настройку для загрузки весов и иметь Node.js 22. На Windows необходима видеокарта с минимум 12 ГБ памяти, а на Apple Silicon — 16 ГБ объединённой памяти.
