Compositor — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для Claude Code и других агентов: читает и меняет проекты Compositor — слои, маски, трансформации, экспорт — без открытия графического редактора.
MIT ★ 8 обновлён 2026-09-25
claude mcp add compositor -- npx -y compositor-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 сам не следит за изменениями файлов. Если документ уже открыт, после правки агентом его придётся закрыть и открыть заново.
Какие задачи решает
- создать новый документ с фоновым слоем
- добавить фото и логотипы как слои с режимами наложения
- экспортировать пиксели слоя или маску в файл
- переставить слои между папками до открытия результата
- прикрепить инвертированную серую маску к слою
Примеры запросов агенту
- Создай проект 1920×1080 в
~/Desktop/poster.compс белым фоном, добавьphoto.jpgс масштабом fill, положиlogo.pngв правый нижний угол с непрозрачностью 80% и режимом Multiply, затем покажи превью и открой в Compositor. - Поменяй у слоя
logoнепрозрачность на 60 и сдвинь его в левый верхний угол. - Экспортируй проект
poster.compв сглаженный JPEG и верни мне файл.
Как установить Compositor
Командой платформы
claude mcp add compositor -- npx -y compositor-mcpКомандой платформы
codex mcp add compositor -- npx -y compositor-mcpФайл настроек
{
"mcpServers": {
"compositor": {
"command": "npx",
"args": [
"-y",
"compositor-mcp"
]
}
}
}Файл настроек
{
"servers": {
"compositor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"compositor-mcp"
]
}
}
}Командой платформы
gemini mcp add compositor npx -y compositor-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Compositor
Как установить Compositor в Claude Code?
Установи Node.js 20 или новее, затем выполни claude mcp add compositor -- npx -y compositor-mcp.
Что делает Compositor?
Это MCP-сервер, через который агент читает и редактирует .comp-проекты: осматривает слои, меняет порядок, задаёт маски, рендерит превью и экспортирует PNG или JPEG. Сам Compositor нужен только для просмотра результата.
Почему превью не совпадает с экспортом из Compositor?
Встроенный превью-рендерер пока не отрисовывает обтравочные маски, корректирующие слои и эффекты слоёв, а инструмент сообщает, что пропущено. Ориентируйся на собственный экспорт Compositor.