内容
# Photoshop MCP Pro
专业的Model Context Protocol服务器，让AI助手直接驱动Adobe Photoshop — 创建和编辑文档、管理图层、运行滤镜和调整、构建形状和文本，并应用更高级别的设计智能，如调色板生成、字体配对和效果配方。
它通过stdio在本地运行，并通过特定于平台的执行器（支持macOS和Windows）执行ExtendScript来控制Photoshop。Photoshop在第一次工具调用时**延迟**启动，因此服务器立即启动，只有在实际使用时才打开Photoshop。
## 功能
**核心编辑工具**
- **文档** — 创建、打开、保存、导出、调整大小、裁剪、扁平化
- **图层** — 创建、复制、分组、重新排序、蒙版、混合模式、不透明度
- **选择** — 矩形/椭圆形、按颜色、反转、羽化、修改
- **变换** — 移动、缩放、旋转、倾斜、翻转
- **形状和路径** — 矢量形状、路径、填充、描边
- **文本** — 文本图层、字体、对齐、颜色
- **图像** — 调整、滤镜、模糊、锐化、噪点
- **调整** — 亮度/对比度、色相/饱和度、色阶、曲线、颜色平衡
- **滤镜** — 高斯/运动模糊、锐化、噪点等
- **颜色** — 前景色/背景色、色样、采样
- **参考线** — 参考线和标尺
- **智能对象** — 创建和管理智能对象
- **历史记录** — 撤销/重做、快照
- **样式** — 图层样式（投影、描边、发光等）
- **导出** — PNG、JPEG和文档导出
- **工作流程** — 多步骤复合操作
- **脚本** — 运行任意ExtendScript
**设计智能**
- **调色板** — 从情绪、图像或品牌生成调色板
- **字体排版** — 建议字体配对、安装字体、自动调整大小
- **配方** — 12种效果配方，带有情绪映射
- **分析** — 通过`ps_review`自动进行设计评分（颜色、对比度、字体排版、构图）
**资源和提示**
- 用于预设、调色板、字体、配方和设计知识的内置资源
- `create-design`提示，用于启动引导式设计工作
## 要求
- **Adobe Photoshop** （启用脚本编写 — 默认）
- **Node.js** >= 18
- **macOS 或 Windows**
## 安装
```bash
git clone https://github.com/ayushnagvanshi101098-ship-it/photoshop-mcp-pro.git
cd photoshop-mcp-pro
npm install
npm run build
```
这会将`src/`中的TypeScript编译到`dist/`中。
## 使用
将服务器添加到MCP客户端。入口点是`dist/index.js`。
### Claude Desktop / Claude Code
```json
{
"mcpServers": {
"photoshop": {
"command": "node",
"args": ["/绝对路径/to/photoshop-mcp-pro/dist/index.js"]
}
}
}
```
重启客户端。Photoshop在第一次调用工具时自动打开。
## 开发
```bash
npm run dev # tsc --watch — 重新编译
npm run build # 一次性编译
npm start # 运行编译后的服务器
```
源代码布局：
```
src/
index.ts # 服务器入口 — 注册工具、资源、提示
platform/ # 操作系统检测 + ExtendScript执行器（macOS / Windows）
tools/ # MCP工具定义
scripts/ # 按工具类别划分的ExtendScript生成器
resources/ # 预设、调色板、字体、配方、设计知识
prompts/ # 设计提示
utils/ # 颜色数学、设计分析器、字体管理器、日志记录
```
## 工作原理
每个工具都构建一个ExtendScript代码段，并将其交给平台执行器，该执行器在Photoshop中运行它并返回结果。连接层处理延迟启动、重新连接和重新启动，如果Photoshop在会话中途退出。
## 许可证
[MIT](LICENSE) © Ayush Nagvanshi
