# 00bx-photoshop-mcp 中文文档

规范地址：https://npmcn.com/package/00bx-photoshop-mcp/

版本：1\.1\.2
npm 元数据更新时间：2026-02-11T00:19:46.814Z
中文译文更新时间：2026-10-31T10:26:18.558Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/00bx-photoshop-mcp
原文对照：https://npmcn.com/package/00bx-photoshop-mcp/?lang=original
项目主页：https://github.com/00bx/00bx-photoshop-mcp#readme
源码仓库：https://github.com/00bx/00bx-photoshop-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.5 MB，81 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-02-10T13:07:35.479Z
- 最新版本发布：2026-02-11T00:19:46.371Z
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

adobephotoshop的MCP服务器。323工具+ 7 AI技能设计自动化。

## 安装

```sh
npm install 00bx-photoshop-mcp
```

也可以使用：`pnpm add 00bx-photoshop-mcp`、`yarn add 00bx-photoshop-mcp`、`bun add 00bx-photoshop-mcp`

## README

# 00 bx-photoshop-mcp

![00bx-photoshop-mcp](https://npmcn.com/package/00bx-photoshop-mcp/poster.jpg)

Adobe Photoshop的MCP服务器。323工具+ 7 AI技能，通过OpenCode实现设计自动化。

## 安装

```bash
npm install -g 00bx-photoshop-mcp
00bx-photoshop-mcp-install
```

将所有内容安装到 `~/.00bx-photoshop-mcp/` 和7个OpenCode技能 `~/.config/opencode/skills/`.

## 设置

### 1\. 启动代理

```bash
cd ~/.00bx-photoshop-mcp/adb-proxy-socket && node proxy.js
```

继续运行。背景的选择:

```bash
nohup node proxy.js > /tmp/ps-proxy.log 2>&1 &
```

### 2\. 加载UXP插件

1.  开放 **Adobe UXP开发人员工具** （来自Creative Cloud）
2.  添加插件->选择 `~/.00bx-photoshop-mcp/uxp/ps`
3.  点击加载
4.  打开Photoshop

### 3\. 增加MCP配置

将......添加到...... `~/.config/opencode/opencode.json`：

```json
{
  "mcp": {
    "adobe-photoshop": {
      "type": "local",
      "command": [
        "~/.00bx-photoshop-mcp/mcp/.venv/bin/python",
        "~/.00bx-photoshop-mcp/mcp/ps-mcp.py"
      ],
      "timeout": 30000,
      "enabled": true
    }
  }
}
```

重启OpenCode。完成了。

## 包括什么

### 323工具

| 类别 | 示例 |
| --- | --- |
| 过滤器 | 高斯模糊，运动模糊，油画，锐化，噪声，像素，失真 |
| 图层样式 | 投影，内发光，斜角，渐变叠加，描边 |
| 形状 | 矩形，椭圆，多边形，直线，箭头，自定义路径 |
| 选择 | 主题，天空，颜色范围，焦点区域，扩展，羽毛 |
| 文本 | 单行/多行，编辑属性 |
| 转换 | 缩放，旋转，翻转，透视，扭曲，内容感知缩放 |
| 调整 | 亮度，色调/饱和度，曲线，水平，色彩平衡，活力 |
| 帆布 | 创建，裁剪，调整大小，旋转，修剪 |
| 层 | 创建，复制，删除，分组，合并，可见性，位置 |
| batchPlay | 直接执行任何Photoshop命令 |

### 7个AI技能（自动安装）

技能按需加载，这样它们就不会吞噬你的上下文窗口。

| 技能 | 它涵盖了什么 |
| --- | --- |
| `ps-fundamentals` | 核心规则，坐标系统，掩码，智能对象 |
| `ps-blend-modes` | 所有混合模式的公式和快速参考 |
| `ps-tool-catalog` | 按类别完成323个工具参考 |
| `ps-batchplay` | BatchPlay描述符，引用表单，事件代码 |
| `ps-text-effects` | 19验证文本效果配方与确切的参数 |
| `ps-photo-effects` | 13照片效果+ 4颜色分级食谱 |
| `ps-advanced` | 过滤器范围，工作流程模板，陷阱，质量检查表 |

## 体系结构

```
OpenCode <-> MCP Server (Python) <-> Proxy (Node) <-> UXP Plugin <-> Photoshop
```

## 要求

-   Adobe Photoshop 2025/2026
-   Adobe UXP开发人员工具
-   Python 3.10 +
-   node . js 18 +
-   OpenCode

## 故障排除

**“无法连接到photoshop”**

-   检查代理是否正在运行： `lsof -i :3001`
-   检查是否加载了UXP插件
-   确保Photoshop打开

**MCP在OpenCode中没有显示**

-   验证配置: `cat ~/.config/opencode/opencode.json | python3 -m json.tool`
-   重启OpenCode

**命令超时**

-   将超时时间增加到 `60000` 在你的配置中
-   首先在Photoshop中打开一个文档（有些命令需要）

## 归因

叉形的 [mikechambers / adb-mcp](https://github.com/mikechambers/adb-mcp)． 从50个扩展到323个工具，具有完整的过滤器/效果覆盖。

## 许可证

麻省理工学院

## 常见问题

### 00bx-photoshop-mcp 是什么？

adobephotoshop的MCP服务器。323工具\+ 7 AI技能设计自动化。

### 如何安装 00bx-photoshop-mcp？

在项目目录运行 npm install 00bx-photoshop-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 00bx-photoshop-mcp、00bx-photoshop-mcp-install，可以用 npx 00bx-photoshop-mcp 直接运行。

### 00bx-photoshop-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/00bx-photoshop-mcp 是否存在。

### 00bx-photoshop-mcp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### 00bx-photoshop-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### 00bx-photoshop-mcp 可以商用吗？

00bx-photoshop-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### 00bx-photoshop-mcp 还在维护吗？

最新版本 1\.1\.2 发布于 2026/02/11（8 个月前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/02/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。