Photopea MCP Server
MCP-сервер редактирует изображения через Photopea: слои, текст, эффекты и экспорт, 46 инструментов для Claude Code и Cursor.
- 53 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер выполняет JavaScript-команды в редакторе Photopea в вашем браузере.
- Изображения проходят через веб-редактор стороннего сервиса.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/photopea-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер выполняет JavaScript-команды в редакторе Photopea в вашем браузере.
- Изображения проходят через веб-редактор стороннего сервиса.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Photopea MCP Server передает команды агента в браузерный редактор Photopea, бесплатную замену Photoshop. Сервер говорит с агентом по stdio, превращает вызовы в JavaScript-команды Photopea и выполняет их через мост на WebSocket и `postMessage`. При первом вызове инструмента автоматически открывается вкладка браузера, это ожидаемое поведение: редактор работает только там. Инструментов 46, они сгруппированы по задачам: документ (9), слои (16), текст и фигуры (3), изображение и эффекты (10), экспорт и служебные (8). Агент может собрать постер или обложку альбома, ретушировать фото, наложить текст и эффекты и выгрузить результат. В репозитории есть демонстрационный промпт `examples/album-cover-demo.md` и образ Docker.
Для кого. Дизайнерам и разработчикам, которым агент должен править изображения, делать обложки и постеры без ручной работы в редакторе.
Подходит, если
- Агент собирает обложку альбома по описанию: фон, слои и текст.
- Нужно массово обрезать и экспортировать картинки в одном формате.
- Фото ретушируют фильтрами и эффектами по текстовой команде.
- Макет правят прямо из терминала, не открывая редактор вручную.
Не подходит, если
- Нужен офлайн-редактор без браузера.
- Файлы нельзя открывать в веб-редакторе стороннего сервиса.
- Требуется точная работа в самом Photoshop или со сложными PSD-плагинами.
Пример запроса к агенту
Сделай обложку альбома 3000x3000 с названием «Nightfall», темным фоном и градиентом, затем экспортируй PNG.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер зависит от открытой вкладки Photopea: если закрыть ее, следующий вызов откроет вкладку снова. Изображения обрабатываются в браузерном редакторе Photopea, поэтому закрытые материалы не стоит загружать без оценки политики сервиса. Часть возможностей зависит от Photopea API, и поведение отдельных инструментов может отличаться от настольного Photoshop. Для запуска нужны Node.js и `npx`, ключей API сервер не требует.
Как отключить. Удалите подключение командой `claude mcp remove photopea` или уберите запись из конфигурации клиента, закройте вкладку Photopea.
Частые вопросы
Как подключить Photopea MCP к Claude Code?
Командой `claude mcp add -s user photopea -- npx -y photopea-mcp-server`. Затем начните новую сессию.
Почему открывается браузер?
Photopea работает только в браузере, поэтому сервер открывает вкладку при первом вызове инструмента. Если закрыть ее, она откроется снова.
Какие клиенты поддерживаются?
Claude Code, Claude Desktop, Cursor, VS Code с Copilot и Windsurf. Для каждого в README есть фрагмент конфигурации.
Сколько инструментов у сервера?
46: документ, слои, текст и фигуры, изображение и эффекты, экспорт и служебные.
Как установить глобально?
Командой `npm install -g photopea-mcp-server`, затем `claude mcp add -s user photopea -- photopea-mcp-server`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Adobe Photoshop: удаление фона, ретушь, экспорт для соцсетей и пакетные операции голосом
MCP-сервер для Windows, который управляет установленным Photoshop: документы, слои и произвольные скрипты JSX
MCP-сервер дает агенту редактирование изображений в GIMP со снимками результата, слоями, фильтрами и экспортом файлов.
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
MCP-сервер дает агенту 123 инструмента Aseprite для пиксель-арта и анимации и снимки, по которым он проверяет рисунок
MCP-сервер подключает агента к каталогу Lightroom Classic: поиск фото, рейтинги, настройки проявки, коллекции и экспорт.
Коротко о README
Схема работы: агент, MCP-сервер, мост на WebSocket, браузер и Photopea. В README есть демо, быстрый старт, список инструментов и примеры запросов.