# Kokon

Локальная генерация и обработка картинок через Qwen-Image 2.1 на собственном видеочипе прямо из редактора. Работает без облачных API и ключей доступа.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 212
- Автор: GabrieleLozupone
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/GabrieleLozupone/kokon/tree/HEAD/mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `QLS_MCP_ALLOWED_DIRS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y kokon-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp --env QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> -- npx -y kokon-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kokon-mcp"
            ],
            "env": {
                "QLS_MCP_ALLOWED_DIRS": "<QLS_MCP_ALLOWED_DIRS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kokon-mcp"
            ],
            "env": {
                "QLS_MCP_ALLOWED_DIRS": "<QLS_MCP_ALLOWED_DIRS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e QLS_MCP_ALLOWED_DIRS=<QLS_MCP_ALLOWED_DIRS> mcp npx -y kokon-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- сгенерировать иллюстрацию по текстовому описанию и референсам прямо в кодовой базе
- стереть лишние детали или перерисовать фон на скриншоте через inpainting
- увеличить разрешение картинки в два раза без передачи файлов на сторонние сервисы
- проверить текущую нагрузку на видеопамять и очередь задач локального движка

## Примеры запросов агенту
- Сделай главное изображение для файла `README.md` и сохрани его в папку `docs/`
- Удали лишние элементы со скриншота `screenshot.png` с помощью инструмента `inpaint_image`
- Увеличь разрешение файла `preview.png` в два раза через `upscale_image`

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/nevibecode/mcp/agent-skills-search-server.md) — MCP-сервер · ★ 26559
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [PraisonAI](https://affpapa.org/nevibecode/mcp/praisonai.md) — MCP-сервер · ★ 9289

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md