MCP Server

通过 MCP (Model Context Protocol) 将 Photoshop 图层信息暴露给 AI，实现 PSD 到 HTML 的智能还原。

架构

AI Client → MCP Server → File Bridge → UXP Plugin → Photoshop

• MCP Server 接收工具调用
• 通过 File Bridge（文件系统）写入命令到 /private/tmp/psd-restore-bridge/commands/
• UXP 插件轮询并执行，结果写回 results/
• MCP Server 返回结果给调用方

Bridge 目录

默认：/private/tmp/psd-restore-bridge 覆盖：PSD_RESTORE_BRIDGE_DIR=/path/to/bridge

返回精简

所有工具默认返回 HTML/CSS 还原所需的最小字段集（在 src/filters.ts 中定义）。 如需全量数据，工具描述中未提供 full 参数，不可恢复。

开发

npm run build    # 编译 TypeScript → dist/
npm run dev      # tsx 直接运行（开发用）

本地测试

node tests/call-tool.mjs <工具名> '<参数 JSON>'

示例：

node tests/call-tool.mjs get_active_document '{}'
node tests/call-tool.mjs get_text_data '{"layerId":"文档名/图层路径/id"}'

工具清单

见 src/toolSpecs.ts，共 22 个原子工具。