Kokon

Kokon — MCP-сервер сообщества (автор — GabrieleLozupone). Офлайн-генерация и правка изображений моделью Qwen-Image на вашей видеокарте. Лицензия AGPL-3.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
GabrieleLozupone
Лицензия
AGPL-3.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
rust

Уровень риска: high

Читает и сохраняет изображения в папке проекта, папке вывода Kokon и каталогах из QLS_MCP_ALLOWED_DIRS; не перезаписывает файлы; веса модели — некоммерческая лицензия.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"kokon\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kokon-mcp\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README для .mcp.json, Claude Desktop, Cursor и других",
    "verified": "docs"
}

Что умеет

kokon-mcp — MCP-сервер для настольного приложения Kokon. Он позволяет Claude Code, Cursor, Claude Desktop и другим MCP-клиентам создавать и редактировать изображения моделью Qwen-Image 2.1, которая работает офлайн на вашей видеокарте. Ключ API и облако не нужны: всё происходит на 127.0.0.1.

Пакет — только мост между агентом и приложением. Приложение не обязательно держать открытым: сервер сам запускает движок по запросу. Подсказки передаются ровно в том виде, в каком их пишет ассистент: собственный помощник Kokon по составлению подсказок для MCP не работает.

Инструменты:

  • generate_image — изображение по тексту, при желании с 10 референсами (человек, товар, стиль); размер выбирается автоматически или задаётся явно;
  • edit_image — правка по инструкции с сохранением размера, исходник не перезаписывается;
  • edit_images — правка первого изображения с опорой на ещё 9;
  • inpaint_image и outpaint_image — изменение области по маске и расширение за края кадра;
  • upscale_image — увеличение (по умолчанию в 2 раза, до 8192 пикселей);
  • get_image_info и get_generator_status — сведения об изображении и состояние движка, видеокарты и очереди.

Кому подойдёт

  • Разработчикам и авторам документации, которым нужны иллюстрации прямо из агента без облачных сервисов.
  • Тем, кто не хочет отправлять изображения в облако: генерация идёт локально.

Похожие серверы — в категории медиа и творчество.

Установка

Нужно приложение Kokon: Windows с видеокартой от 12 ГБ (NVIDIA, а AMD и Intel — в бета-версии) или Mac на Apple Silicon с 16 ГБ и больше (бета). Скачайте его с kokon.app, откройте один раз и завершите настройку, чтобы модель загрузилась.

Для запуска моста через npx нужен Node.js 22 или новее:

npx -y kokon-mcp

Установщик Kokon также содержит этот сервер в виде отдельного исполняемого файла kokon-mcp внутри приложения — он подойдёт, если вы не хотите ставить Node.js.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add --scope user kokon -- npx -y kokon-mcp

README приводит этот JSON для любых клиентов со стандартным конфигом: .mcp.json, Claude Desktop, Cursor и других.

Проверка

Попросите ассистента вызвать get_generator_status: он покажет состояние движка и видеопамять. Первый запрос на генерацию занимает около минуты, пока загружается модель.

Примеры задач

Создай обложку для этого README и сохрани её в docs/.
Убери лишние предметы с фона на screenshot.png и увеличь результат в 2 раза.

Риски

  • Чтение и запись файлов. Сервер читает и сохраняет изображения в папке проекта (CLAUDE_PROJECT_DIR или рабочий каталог), в папке вывода Kokon и в каталогах из QLS_MCP_ALLOWED_DIRS. Существующие файлы не перезаписываются. Не добавляйте в разрешённые каталоги лишнее.
  • Лицензия модели. Сам сервер распространяется под AGPL-3.0, а веса Qwen-Image 2.1 — под Qwen Research License, которая запрещает коммерческое использование. Учитывайте это при работе с изображениями.
  • Нагрузка на компьютер. Генерация занимает видеокарту и память; следите за очередью через get_generator_status.

Частые вопросы

Отправляются ли изображения в облако?

Нет. Всё работает на вашем компьютере через 127.0.0.1. По умолчанию изображения не передаются даже модели ассистента; для небольшого превью JPEG передайте include_preview: true.

Нужно ли держать Kokon открытым?

Нет. Сервер запускает движок по запросу, но приложение нужно один раз открыть и завершить настройку.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники