포토페라 MCP 계정 관리

디자인 포스터, 사진 편집 및 이미지를 터미널에서 직접 변환합니다. Photopea에 의해 구동 – 무료, Photoshop에 브라우저 기반 대안 – MCP를 통해 AI 에이전트에 연결 .

데모

이 데모에서 사용 Prompt : 예 / 앨범 - cover-demo.md

그것이 작동하는 방법

에이전트는 MCP 프로토콜을 통해 편집 명령을 보냅니다. 서버는 Photopea JavaScript API 호출으로 변환하고 WebSocket Bridge를 브라우저로 실행합니다.

주: 브라우저 창은 첫번째 도구 호출에서 자동으로 열립니다. – Photopea는 브라우저에서 완전히 실행되며 서버는 이미지 편집 작업을 수행해야합니다.

빠른 시작

그런 다음 새로운 Claude Code 세션을 시작하고 이미지를 편집하도록 요청하십시오. Photopea 편집기는 첫 번째 도구 호출에서 브라우저에서 자동으로 열립니다.

설치

Claude 코드

npx (추천):

글로벌 설치:

Claude 데스크탑

macOS에서 Claude Desktop config 파일 (~/Library/Application Support/Claude/claude_desktop_config.json]에 추가하십시오.

# # # 커서

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",