# Compositor

MCP-сервер для Claude Code и других агентов: читает и меняет проекты Compositor — слои, маски, трансформации, экспорт — без открытия графического редактора.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 у репозитория
- Автор: Josusanz
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Josusanz/compositor-mcp
- Обновлён: 2026-09-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/compositor

## Что делает

Сервер работает с форматом `.comp`: это папка с `manifest.json` и PNG на каждый слой. Агенту не нужен запущенный Compositor, чтобы поменять состав проекта: инструменты сервера читают документ, меняют слои и сохраняют файлы обратно. После правок проект можно открыть в приложении и продолжить работу.

Внутри — `create_project`, `add_image_layer`, `add_folder`, `set_layer`, `move_layer`, `remove_layer`, `replace_layer_image`, `set_layer_mask`, `resize_canvas`, `render_preview`, `export_flattened`, `export_layer` и `open_in_compositor`. Превью отдаёт сглаженный PNG как изображение, поэтому модель видит текущий вид композиции. Поля, которые сервер не понимает, например текст, фигуры, эффекты или корректирующие слои, сохраняются при повторной записи.

Перед установкой нужен Node.js 20 или новее. Ограничение: превью не отрисовывает обтравочные маски, корректирующие слои и эффекты слоёв, а Compositor сам не следит за изменениями файлов. Если документ уже открыт, после правки агентом его придётся закрыть и открыть заново.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add compositor -- npx -y compositor-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add compositor -- npx -y compositor-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "compositor": {
            "command": "npx",
            "args": [
                "-y",
                "compositor-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "compositor": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "compositor-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add compositor npx -y compositor-mcp
```

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

## Примеры запросов агенту
- Создай проект 1920×1080 в `~/Desktop/poster.comp` с белым фоном, добавь `photo.jpg` с масштабом fill, положи `logo.png` в правый нижний угол с непрозрачностью 80% и режимом Multiply, затем покажи превью и открой в Compositor.
- Поменяй у слоя `logo` непрозрачность на 60 и сдвинь его в левый верхний угол.
- Экспортируй проект `poster.comp` в сглаженный JPEG и верни мне файл.

## Похожие
- [scenario-video-assembly](https://affpapa.org/nevibecode/skills/scenario-video-assembly.md) — скилл · 919 установок
- [image-edit](https://affpapa.org/nevibecode/skills/image-edit.md) — скилл · 448100 установок
- [image-outpainting](https://affpapa.org/nevibecode/skills/image-outpainting.md) — скилл · 387500 установок
- [scenario-image](https://affpapa.org/nevibecode/skills/scenario-image.md) — скилл · 1100 установок
- [cli-anything-gimp](https://affpapa.org/nevibecode/skills/cli-anything-gimp.md) — скилл · 710 установок
- [openrouter-images](https://affpapa.org/nevibecode/skills/openrouter-images.md) — скилл · 580 установок

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