attalla1/photopea-mcp-server

Фотопия MCP сервер

Дизайн плакатов, редактирование фотографий и преобразование изображений непосредственно из вашего терминала. Работает на Photopea - бесплатной браузерной альтернативе Photoshop - подключен к вашему агенту ИИ через MCP.

Демо

Оперативность, используемая в этом демо: examples/album-cover-demo.md

Как это работает

Ваш агент отправляет команды редактирования через протокол MCP. Сервер переводит их в вызовы API Photopea JavaScript и выполняет их через мост WebSocket в браузер.

Примечание: Окно браузера откроется автоматически при первом вызове инструмента. Ожидается, что Photopea полностью работает в браузере, и серверу необходимо выполнить операции по редактированию изображений.

Быстрый старт

Затем начните новую сессию Claude Code и попросите ее редактировать изображения. Редактор Photopea откроется в вашем браузере автоматически при первом вызове инструмента.

##Установка

###Клауд Код

npx (рекомендуется):

Глобальная установка

###Клод Десктоп

Добавьте файл конфигурации Claude Desktop ([T0]) в macOS:

Курсор

Добавьте настройки Cursor MCP .cursor/mcp.json в вашем проекте или ~/.cursor/mcp.json по всему миру:

Photopea MCP Server

Design posters, edit photos, and transform images directly from your terminal. Powered by Photopea – a free, browser-based alternative to Photoshop – connected to your AI agent via MCP.

Demo

Prompt used in this demo: examples/album-cover-demo.md

How It Works

graph LR
    A[Agent] |stdio| B[MCP Server]
    B |WebSocket| C[Browser]
    C |postMessage| D[Photopea]

Your agent sends editing commands through the MCP protocol. The server translates these into Photopea JavaScript API calls and executes them via a WebSocket bridge to the browser.

Note: A browser window will open automatically on the first tool call. This is expected – Photopea runs entirely in the browser and the server needs it to perform image editing operations.

Quick Start

claude mcp add -s user photopea -- npx -y photopea-mcp-server

Then start a new Claude Code session and ask it to edit images. The Photopea editor will open in your browser automatically on the first tool call.

Installation

Claude Code

npx (recommended):

claude mcp add -s user photopea -- npx -y photopea-mcp-server

Global install:

npm install -g photopea-mcp-server
claude mcp add -s user photopea -- photopea-mcp-server

Claude Desktop

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "photopea": {
      "command": "npx",
      "args": ["-y", "photopea-mcp-server"]
    }
  }
}

Cursor

Add to Cursor MCP settings (.cursor/mcp.json in your project or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "photopea": {
      "command": "npx",