Photoshop MCP Server logo

Photoshop MCP Server

by loonghao

A Model Context Protocol (MCP) server for Photoshop integration using photoshop-python-api. It allows AI assistants and other MCP clients to control Photoshop programmatically.

View on GitHub

Last updated: N/A

What is Photoshop MCP Server?

This project provides a bridge between the Model Context Protocol (MCP) and Adobe Photoshop, allowing AI assistants and other MCP clients to control Photoshop programmatically.

How to use Photoshop MCP Server?

Install the server using pip or uv. Configure your MCP host (like Claude Desktop) with the provided JSON configuration, specifying the Photoshop version and command to run the server. Then, use your AI assistant to send commands that leverage the available resources and tools to interact with Photoshop.

Key features of Photoshop MCP Server

  • Photoshop application info retrieval

  • Active document info retrieval

  • Layer information retrieval

  • Document creation, opening, and saving

  • Layer creation (text, solid color)

  • Session information access

Use cases of Photoshop MCP Server

  • Automating Photoshop tasks with AI assistants

  • Programmatically creating and modifying Photoshop documents

  • Integrating Photoshop into automated workflows

  • Generating images based on user prompts

  • Extracting information from Photoshop documents

FAQ from Photoshop MCP Server

What operating systems are supported?

Only Windows OS is supported due to the use of COM interface.

Which Photoshop versions are compatible?

Tested with versions CC2017 through 2024.

What Python version is required?

Python 3.10 or higher.

How do I specify the Photoshop version to use?

Use the PS_VERSION environment variable in your MCP host configuration (e.g., PS_VERSION=2024).

What are some example commands I can use?

You can create a new document, add a text layer, get document information, and more. Refer to the 'Available Tools' section for a list of available functionalities.