Photoshop MCP Server

⚠️ 仅限 Windows: 由于依赖于特定于 Windows 的 COM 接口，此服务器仅在 Windows 操作系统上运行。

这是一个使用 photoshop-python-api 将 Photoshop 集成到 Model Context Protocol (MCP) 的服务器。

英文 | 简体中文

概述

该项目提供了一个连接 Model Context Protocol (MCP) 和 Adobe Photoshop 的桥梁，使 AI 助手和其他 MCP 客户端能够通过编程方式控制 Photoshop。

它能做什么？

有了这个 MCP 服务器，AI 助手可以：

• 创建、打开和保存 Photoshop 文档
• 创建和操作图层（文本、纯色等）
• 获取关于 Photoshop 会话和文档的信息
• 应用效果和调整图像
• 还有很多其他功能！

要求

系统要求

• 🔴 仅限 Windows 操作系统: 此服务器仅在 Windows 操作系统上运行
  • 该服务器依赖于特定于 Windows 的 COM 接口与 Photoshop 通信
  • macOS 和 Linux 不支持且无法运行此软件

软件要求

• Adobe Photoshop: 必须本地安装（已测试版本 CC2017 至 2024）
• Python: 版本 3.10 或更高

安装

注意: 记住这个包仅适用于 Windows 系统。

# 使用 pip 安装
pip install photoshop-mcp-server

# 或者使用 uv 安装
uv install photoshop-mcp-server

MCP 主机配置

此服务器设计用于与各种 MCP 主机一起工作。PS_VERSION 环境变量用于指定要连接的 Photoshop 版本（例如，“2024”，“2023”，“2022”等）。

推荐使用 uvx 命令来配置服务器，这是官方标准格式。

标准配置（推荐）

将以下内容添加到您的 MCP 主机配置中（适用于 Claude Desktop，Windsurf，Cline 和其他 MCP 主机）：

{
  "mcpServers": {
    "photoshop": {
      "command": "uvx",
      "args": ["--python", "3.10", "photoshop-mcp-server"],
      "env": {
        "PS_VERSION": "2024"
      }
    }
  }
}

配置选项

• PS_VERSION: 指定要连接的 Photoshop 版本（例如，“2024”，“2023”，“2022”等）
• command: 使用 uvx 作为标准方法
• args: 使用 ["photoshop-mcp-server"] 来运行 Photoshop MCP 服务器
  • 若要明确指定 Python 版本，请使用 ["--python", "3.10", "photoshop-mcp-server"]（支持从 3.10 到 3.14 的任何版本）

主要功能

可用资源

• photoshop://info - 获取 Photoshop 应用程序信息
• photoshop://document/info - 获取活动文档信息
• photoshop://document/layers - 获取活动文档中的图层

可用工具

服务器提供了多种工具来控制 Photoshop：

• 文档工具: 创建、打开和保存文档
• 图层工具: 创建文本图层、纯色图层等
• 会话工具: 获取关于 Photoshop 会话、活动文档、选择的信息

AI 助手示例提示

一旦在您的 MCP 主机中配置好，您可以在 AI 助手对话中使用 Photoshop MCP 服务器。这里有一些示例提示帮助您开始：

基本示例

用户: 你能创建一个新的 Photoshop 文档并在其中添加一个带有 "Hello World" 的文本图层吗？

AI 助手: 我会为您创建一个新的文档并添加文本图层。

[AI 使用 Photoshop MCP 服务器进行以下操作：
1. 使用 `create_document` 工具创建新文档
2. 使用 `create_text_layer` 工具添加带有 "Hello World" 的文本图层]

我已经创建了一个新的 Photoshop 文档，并添加了一个带有 "Hello World" 的文本图层。

更高级示例

用户: 打开我最新的 PSD 文件并告诉我它有多少个图层。

AI 助手: 我会检查您的最新 PSD 文件并计算图层数。

[AI 使用 Photoshop MCP 服务器进行以下操作：
1. 获取关于打开文档的信息
2. 如果没有文档打开，它可以浏览并打开一个 PSD 文件
3. 检索并分析图层结构]

您的文档有 12 个图层，包括 3 个组文件夹和 2 个调整图层。

用户: 创建一个带有渐变背景和 "夏季促销" 字样的社交媒体帖子，字体要加粗。

AI 助手: 我会为您创建那个社交媒体帖子。

[AI 使用 Photoshop MCP 服务器进行以下操作：
1. 创建一个适合社交媒体尺寸的新文档
2. 创建一个带有夏季颜色的渐变填充图层
3. 添加一个带有 "夏季促销" 字样的文本图层，字体加粗
4. 合适地定位和样式化文本]

我已经为您创建了一个带有渐变背景和加粗 "夏季促销" 文字的社交媒体帖子。

许可证

MIT

致谢

• photoshop-python-api - Photoshop 的 Python API
• Model Context Protocol - MCP Python SDK