项目简介

Photoshop MCP服务器是一个桥梁,它将 Model Context Protocol (MCP) 与 Adobe Photoshop 连接起来。借助此服务器,AI 助手和其他 MCP 客户端可以通过标准化的 MCP 协议,以编程方式控制 Photoshop,实现图像编辑和处理的自动化。

主要功能点

  • 资源访问: 提供对Photoshop应用程序和文档信息的访问,例如Photoshop版本、当前文档信息、图层列表等。
  • 工具调用: 支持调用Photoshop的各种功能,例如创建、打开、保存文档,创建文本图层、颜色填充图层,以及获取会话信息、文档信息和选区信息等。
  • 跨平台兼容: 虽然服务器本身基于Python开发,但可以与任何支持 MCP 协议的客户端进行通信,实现跨平台应用集成。
  • 易于配置: 采用标准 MCP 服务器配置方式,可以方便地集成到各种 MCP Host 环境中,例如 Claude Desktop, Windsurf, Cline 等。

安装步骤

  1. 环境要求:

    • 操作系统:Windows (因为使用了仅Windows可用的COM接口)
    • Adobe Photoshop:已安装在本地 (经测试支持 CC2017 - 2024 版本)
    • Python:版本 3.10 或更高
  2. 安装软件包: 打开命令提示符或 PowerShell,运行以下命令安装 'photoshop-mcp-server' 包:

    pip install photoshop-mcp-server
    # 或者使用 uv
    uv install photoshop-mcp-server

服务器配置

此Photoshop MCP服务器需要配置在 MCP Host 中才能被 MCP 客户端(如AI助手)发现和使用。推荐使用 'uvx' 作为命令来配置服务器,这是官方推荐的标准格式。

在你的 MCP Host 配置文件中(通常是 JSON 格式),添加如下 'mcpServers' 配置段:

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

配置参数说明:

  • server name: 'photoshop' (服务器名称,可以自定义,客户端通过此名称引用服务器)
  • command: 'uvx' (MCP 服务器启动命令,固定为 'uvx')
  • args: '["photoshop-mcp-server"]' (启动参数,固定为 '["photoshop-mcp-server"]')
  • env: '{"PS_VERSION": "2024"}' (环境变量配置,'PS_VERSION' 用于指定要连接的 Photoshop 版本,例如 "2024", "2023", "2022" 等。请根据你安装的Photoshop版本修改)

基本使用方法

完成上述配置后,你的 MCP 客户端(例如集成了 MCP 功能的 AI 助手)应该能够检测到名为 'photoshop' 的 MCP 服务器。

在与 AI 助手的对话中,你可以指示它使用 Photoshop 执行操作。例如:

用户:请创建一个新的Photoshop文档,并在其中添加一个文字图层,内容为 "Hello World"。

AI 助手:好的,我将创建一个新文档并添加文字图层。

(AI 助手将通过 Photoshop MCP 服务器执行以下操作:

  1. 使用 'create_document' 工具创建一个新文档
  2. 使用 'create_text_layer' 工具添加一个文本图层,文字内容为 "Hello World")

AI 助手回复:我已经创建了一个新的Photoshop文档,并添加了文字图层 "Hello World"。

更多工具和资源的使用方法,请参考仓库的 README 文档和示例。

信息

分类

桌面与硬件