MCP 服务器

PS-MCP

An AI-driven integration server that enables natural language control of Adobe Photoshop through the Model Context Protocol. It automates design workflows by facilitating smart asset slicing, layer analysis, and the future generation of UI code from design files.

README

PS-MCP

Photoshop MCP Server - AI驱动的设计工作流自动化

</div>

📋 项目简介

PS-MCP 是一个基于 Model Context Protocol (MCP) 的 Photoshop 集成服务器，旨在通过 AI 大模型（如 Claude、GPT 等）实现对 Adobe Photoshop 的智能控制。

本项目目前处于早期开发阶段，核心目标是实现设计稿的智能切图与资源导出，并计划在未来演进为 「设计稿分析 → 智能切图 → UI 代码生成」 的一站式工作流解决方案。

🎯 项目愿景

第一阶段：智能切图（当前重点）

✅ 通过自然语言指令控制 Photoshop 导出切片
✅ 自动识别设计稿中的图层、组件边界
✅ 支持多种格式导出（PNG、JPG、SVG、WebP）
✅ 智能命名与资源管理

第二阶段：设计稿解析

🔄 图层结构分析与语义理解
🔄 颜色、字体、间距等设计规范提取
🔄 组件库识别与归类

第三阶段：UI 代码生成

📋 基于切图结果生成前端代码（Vue/React/HTML）
📋 自动应用设计规范（Tailwind/UnoCSS）
📋 实现「设计稿 → 可运行代码」的完整闭环

🏗️ 技术架构

┌─────────────────────────────────────────────────────────────┐
│                     AI 大模型 (Claude/GPT)                    │
└───────────────────────┬─────────────────────────────────────┘
                        │ MCP Protocol
┌───────────────────────┼─────────────────────────────────────┐
│                       ▼                                     │
│              ┌────────────────┐                            │
│              │   PS-MCP Server │  ← 本项目                 │
│              │   (Python)     │                            │
│              └───────┬────────┘                            │
│                      │                                      │
│          ┌───────────┴───────────┐                         │
│          │                       │                         │
│          ▼                       ▼                         │
│   ┌──────────────┐      ┌──────────────┐                  │
│   │  Photoshop   │      │   Export     │                  │
│   │   JSX/Script │      │   Assets     │                  │
│   └──────────────┘      └──────────────┘                  │
└─────────────────────────────────────────────────────────────┘

核心技术栈

组件	技术	说明
MCP Server	FastMCP	Python MCP 服务端框架
通信协议	stdio/sse	标准输入输出 / HTTP 流
PS 交互	ExtendScript / UXP	Adobe Photoshop 脚本接口
构建工具	uv	现代 Python 包管理器

🚀 快速开始

环境要求

Python >= 3.14
Adobe Photoshop 2022 或更高版本
Claude Desktop / 其他 MCP 客户端

安装

# 克隆仓库
git clone https://github.com/pangxie231/ps-mcp.git
cd ps-mcp

# 使用 uv 安装依赖
uv sync

# 或使用 pip
pip install -e "."

配置 MCP 客户端

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "ps-mcp": {
      "command": "python",
      "args": ["/path/to/ps-mcp/server.py"]
    }
  }
}

运行

# 开发模式
python server.py

# 或使用 uv
uv run server.py

📊 开发进度

功能模块	状态	说明
MCP 服务框架	✅	基础服务搭建完成
工具注册	✅	测试工具可用
PS 连接层	🚧	开发中...
切图功能	📋	计划中
图层分析	📋	计划中
UI 生成	📋	计划中