Photoshop MCP Server

🌐 Language: English | 한국어

A Model Context Protocol (MCP) server that enables AI assistants to control Adobe Photoshop via Windows COM automation. Built with .NET 10 and C# 14 using the official MCP C# SDK.

Overview

This MCP server exposes Photoshop automation as a set of tools that any MCP-compatible AI client (Claude Desktop, GitHub Copilot, etc.) can invoke. The primary tool is ExecuteJavaScript, which gives the AI full access to Photoshop's scripting engine — allowing it to flexibly decide what to do at runtime.

Requirements

• Windows (COM automation is Windows-only)
• Adobe Photoshop (any version supporting COM automation and DoJavaScript)
• .NET 10 SDK or later

Installation

1. Clone the repository

git clone https://github.com/airtaxi/PhotoshopMcpServer.git
cd PhotoshopMcpServer

2. Build

dotnet build

3. (Optional) Publish as a self-contained executable

dotnet publish PhotoshopMcpServer/PhotoshopMcpServer.csproj -c Release -r win-x64 --self-contained

The executable will be in PhotoshopMcpServer/bin/Release/net10.0-windows/win-x64/publish/.

MCP Server Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A: Run from source (requires .NET SDK)

{
  "mcpServers": {
    "photoshop": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\path\\to\\PhotoshopMcpServer\\PhotoshopMcpServer"]
    }
  }
}

Option B: Run published executable

{
  "mcpServers": {
    "photoshop": {
      "command": "C:\\path\\to\\PhotoshopMcpServer.exe"
    }
  }
}

GitHub Copilot (VS Code)

Add to your .vscode/mcp.json or VS Code settings:

{
  "servers": {
    "photoshop": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\path\\to\\PhotoshopMcpServer\\PhotoshopMcpServer"]
    }
  }
}

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "photoshop": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\path\\to\\PhotoshopMcpServer\\PhotoshopMcpServer"]
    }
  }
}

Note: Replace C:\path\to\PhotoshopMcpServer with the actual path where you cloned the repository.

Available Tools

ExecuteJavaScript — The Power Tool

The ExecuteJavaScript tool is intentionally flexible. It allows the AI to construct and execute any valid Photoshop JavaScript, giving it full control over Photoshop. Example scripts:

// Get document name
app.activeDocument.name

// Create a new document
app.documents.add(1920, 1080, 72, "My Canvas")

// Resize the active document
app.activeDocument.resizeImage(800, 600)

// Flatten all layers
app.activeDocument.flatten()

// Apply Gaussian blur to the active layer
app.activeDocument.activeLayer.

... [View full README on GitHub](https://github.com/airtaxi/PhotoshopMcpServer#readme)