README_zh.md

Photoshop MCP 服务器

⚠️ 仅支持 Windows: 此服务器仅适用于 Windows 操作系统，因为它依赖于 Windows 特有的 COM 接口。

一个使用 photoshop-python-api 的 Photoshop 集成的模型上下文协议 (MCP) 服务器。

English | 简体中文

概述

本项目提供了模型上下文协议 (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