@stacey_1018/lanhu-design-mcp 0.0.0-stage → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +342 -2
- package/dist/app.d.ts +9 -0
- package/dist/app.js +13 -0
- package/dist/app.js.map +1 -0
- package/dist/cache/memory-cache.d.ts +8 -0
- package/dist/cache/memory-cache.js +27 -0
- package/dist/cache/memory-cache.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +68 -0
- package/dist/cli.js.map +1 -0
- package/dist/config.d.ts +16 -0
- package/dist/config.js +30 -0
- package/dist/config.js.map +1 -0
- package/dist/design/assets.d.ts +14 -0
- package/dist/design/assets.js +72 -0
- package/dist/design/assets.js.map +1 -0
- package/dist/design/flatten.d.ts +2 -0
- package/dist/design/flatten.js +20 -0
- package/dist/design/flatten.js.map +1 -0
- package/dist/design/gradient.d.ts +10 -0
- package/dist/design/gradient.js +41 -0
- package/dist/design/gradient.js.map +1 -0
- package/dist/design/parser.d.ts +7 -0
- package/dist/design/parser.js +309 -0
- package/dist/design/parser.js.map +1 -0
- package/dist/design/photoshop.d.ts +9 -0
- package/dist/design/photoshop.js +69 -0
- package/dist/design/photoshop.js.map +1 -0
- package/dist/design/tokens.d.ts +19 -0
- package/dist/design/tokens.js +111 -0
- package/dist/design/tokens.js.map +1 -0
- package/dist/design/types.d.ts +122 -0
- package/dist/design/types.js +2 -0
- package/dist/design/types.js.map +1 -0
- package/dist/errors.d.ts +6 -0
- package/dist/errors.js +25 -0
- package/dist/errors.js.map +1 -0
- package/dist/http/server.d.ts +5 -0
- package/dist/http/server.js +94 -0
- package/dist/http/server.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -0
- package/dist/lanhu/client.d.ts +24 -0
- package/dist/lanhu/client.js +367 -0
- package/dist/lanhu/client.js.map +1 -0
- package/dist/lanhu/types.d.ts +27 -0
- package/dist/lanhu/types.js +2 -0
- package/dist/lanhu/types.js.map +1 -0
- package/dist/mcp/server.d.ts +8 -0
- package/dist/mcp/server.js +341 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/service/asset-service.d.ts +59 -0
- package/dist/service/asset-service.js +195 -0
- package/dist/service/asset-service.js.map +1 -0
- package/dist/service/design-query-service.d.ts +107 -0
- package/dist/service/design-query-service.js +140 -0
- package/dist/service/design-query-service.js.map +1 -0
- package/dist/service/design-service.d.ts +13 -0
- package/dist/service/design-service.js +94 -0
- package/dist/service/design-service.js.map +1 -0
- package/dist/service/gradient-enrichment.d.ts +7 -0
- package/dist/service/gradient-enrichment.js +94 -0
- package/dist/service/gradient-enrichment.js.map +1 -0
- package/dist/user-cookie.d.ts +1 -0
- package/dist/user-cookie.js +74 -0
- package/dist/user-cookie.js.map +1 -0
- package/dist/utils/json-pointer.d.ts +1 -0
- package/dist/utils/json-pointer.js +25 -0
- package/dist/utils/json-pointer.js.map +1 -0
- package/dist/utils/url.d.ts +7 -0
- package/dist/utils/url.js +43 -0
- package/dist/utils/url.js.map +1 -0
- package/docs/MCP_TOOLS_REFERENCE.md +328 -0
- package/package.json +34 -4
package/README.md
CHANGED
|
@@ -1,3 +1,343 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Lanhu Design MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
让 Codex、Cursor、WorkBuddy、Claude 等 AI 客户端直接读取蓝湖设计稿的结构、尺寸、颜色、字体、间距、文案和图片资源,结合业务项目已有组件实现页面。
|
|
4
|
+
|
|
5
|
+
MCP 负责提供设计数据和素材;页面实现、浏览器截图及像素校验由 AI 客户端完成。
|
|
6
|
+
|
|
7
|
+
## 目录
|
|
8
|
+
|
|
9
|
+
- [文档导航](#文档导航)
|
|
10
|
+
- [快速开始:安装 MCP](#快速开始安装-mcp)
|
|
11
|
+
- [通过 npm 包安装](#通过-npm-包安装)
|
|
12
|
+
- [方式一:AI 安装(推荐)](#方式一ai-安装推荐)
|
|
13
|
+
- [方式二:手动安装](#方式二手动安装)
|
|
14
|
+
- [核心能力](#核心能力)
|
|
15
|
+
- [MCP 使用描述示例](#mcp-使用描述示例)
|
|
16
|
+
- [接入 SKILL 使用描述示例](#接入-skill-使用描述示例)
|
|
17
|
+
- [重要边界](#重要边界)
|
|
18
|
+
- [开发与调试](#开发与调试)
|
|
19
|
+
- [stdio 开发运行](#stdio-开发运行)
|
|
20
|
+
- [使用 MCP Inspector 浏览器调试](#使用-mcp-inspector-浏览器调试)
|
|
21
|
+
- [HTTP 模式](#http-模式)
|
|
22
|
+
- [项目结构](#项目结构)
|
|
23
|
+
- [开发命令](#开发命令)
|
|
24
|
+
|
|
25
|
+
## 文档导航
|
|
26
|
+
|
|
27
|
+
| 文档 | 负责内容 |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| 本 README | 项目能力、安装入口、使用示例和开发调试 |
|
|
30
|
+
| [AI 安装指南](AI_INSTALL.md) | 给 AI 执行:安装流程、必要询问、审批配置及验证交付 |
|
|
31
|
+
| [手动安装指南](TEAM_GUIDE.md) | 给同事阅读:环境准备、安装命令、Cookie、客户端配置及连接排查 |
|
|
32
|
+
| [MCP 工具说明](docs/MCP_TOOLS_REFERENCE.md) | 工具参数、返回结构、调用示例及限制 |
|
|
33
|
+
|
|
34
|
+
## 快速开始:安装 MCP
|
|
35
|
+
|
|
36
|
+
推荐每人在自己的电脑上安装,通过 stdio 连接 AI 客户端。npm 包可直接启动,源码安装适合需要开发或调试的用户。
|
|
37
|
+
|
|
38
|
+
### 通过 npm 包安装
|
|
39
|
+
|
|
40
|
+
安装 Node.js 20.19.0 或以上版本。登录蓝湖,在浏览器开发者工具的「网络」面板复制蓝湖请求的完整 Cookie 值。首次使用或更新 Cookie 时,在终端运行以下命令,再按提示粘贴并按回车。
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx --yes --registry=https://registry.npmjs.org/ @stacey_1018/lanhu-design-mcp@0.3.1 --save-cookie
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Windows 的 PowerShell 或 CMD 可把 `npx` 写成 `npx.cmd`。输入不回显,命令保存后会退出。Cookie 保存在当前用户目录下的 `.config/lanhu-design-mcp/.env`。
|
|
47
|
+
|
|
48
|
+
将客户端的 MCP 启动命令配置为以下内容。已有配置时,更新原条目的包版本。新开会话后可用有权限的蓝湖稿验证读取。
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
npx --yes --registry=https://registry.npmjs.org/ @stacey_1018/lanhu-design-mcp@0.3.1 --transport=stdio
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### 方式一:AI 安装(推荐)
|
|
55
|
+
|
|
56
|
+
先在终端中手动克隆源码,将 `<团队仓库地址>` 替换为实际地址(已有源码可跳过):
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
git clone <团队仓库地址> lanhu-design-mcp
|
|
60
|
+
cd lanhu-design-mcp
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
用 AI 编程工具打开该项目目录,再在对话框中复制以下内容:
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
请阅读本项目的 AI_INSTALL.md,在我当前使用的 AI 工具中,
|
|
67
|
+
完成蓝湖 MCP 的安装、构建和用户级配置,并验证连接。
|
|
68
|
+
请按指南中的“重复授权选项”优先使用客户端原生选择界面,
|
|
69
|
+
展示全部三个选项和推荐理由;不可用时再让我回复编号。
|
|
70
|
+
提出选项后请暂停执行,等我明确选择后再处理审批设置并继续后续步骤。
|
|
71
|
+
即使 .env 已存在,也请按指南执行检查命令核对 LANHU_COOKIE 的实际值是否已填写。
|
|
72
|
+
缺少值时请说明获取方法和本机 .env 路径,暂停并等我回复“已填写”,重新检查通过后再继续。
|
|
73
|
+
设计稿链接请留到安装、配置和审批选项处理完成后的真实读取验证阶段再询问。
|
|
74
|
+
请实际执行,保留已有配置,缺少必要信息时再询问。
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
AI 会检查环境、安装依赖、构建服务、引导你在本机填写 Cookie,并配置客户端及验证连接。需要重启客户端时,会说明剩余验证步骤。
|
|
78
|
+
|
|
79
|
+
Cookie 由你在本机填写,不发到聊天中。
|
|
80
|
+
|
|
81
|
+
完整执行流程见 [AI 安装说明](AI_INSTALL.md)。
|
|
82
|
+
|
|
83
|
+
### 方式二:手动安装
|
|
84
|
+
|
|
85
|
+
按 [手动安装教程](TEAM_GUIDE.md) 依次完成:
|
|
86
|
+
|
|
87
|
+
1. **准备环境并构建**:安装 Node.js,获取源码,执行 `npm ci` 和 `npm run build`。
|
|
88
|
+
2. **配置 Cookie**:[获取蓝湖 Cookie](TEAM_GUIDE.md#3-配置蓝湖-cookie),保存在 MCP 项目本机的 `.env` 中。
|
|
89
|
+
3. **添加 MCP**:选择 [Codex 配置](TEAM_GUIDE.md#42-在-codex-中添加)、[Cursor 配置](TEAM_GUIDE.md#43-在-cursor-中添加) 或 [WorkBuddy 配置](TEAM_GUIDE.md#44-在-workbuddy-中添加),使用实际安装路径。
|
|
90
|
+
4. **重启并验证**:检查连接状态,调用工具读取一份有权限的真实设计稿。
|
|
91
|
+
|
|
92
|
+
详细命令和客户端配置见给同事阅读的手动安装指南;遇到问题可查看 [连接排查](TEAM_GUIDE.md#7-连接排查)。
|
|
93
|
+
|
|
94
|
+
## 核心能力
|
|
95
|
+
|
|
96
|
+
- 将蓝湖 DDS 设计数据转换为稳定的 `DesignNode`,保留原始字段和样式。
|
|
97
|
+
- 首次还原可分页读取完整节点;局部更新可先定位区域,再读取目标节点详情。
|
|
98
|
+
- 按需下载设计师切图及同版本完整设计图,固定版本以保持数据和素材一致。
|
|
99
|
+
- 支持 stdio 与 Streamable HTTP,使用短期内存缓存减少重复请求。
|
|
100
|
+
|
|
101
|
+
当前向客户端开放以下 5 个工具,详细参数见 [MCP 工具说明](docs/MCP_TOOLS_REFERENCE.md):
|
|
102
|
+
|
|
103
|
+
| 工具 | 用途 |
|
|
104
|
+
| --- | --- |
|
|
105
|
+
| `lanhu_get_design_assets` | 按需分页查看设计师切图 |
|
|
106
|
+
| `lanhu_download_design_assets` | 下载同版本完整设计图和选定切图 |
|
|
107
|
+
| `lanhu_get_design_nodes` | 首次还原时分页读取完整标准节点、样式和原始字段 |
|
|
108
|
+
| `lanhu_get_design_overview` | 局部更新时定位节点并确定设计版本 |
|
|
109
|
+
| `lanhu_get_design_node_details` | 按锁定版本读取目标节点及必要子树的详细标注 |
|
|
110
|
+
|
|
111
|
+
## MCP 使用描述示例
|
|
112
|
+
|
|
113
|
+
接入 MCP 后,可将以下描述发送给 AI 客户端,按实际任务替换蓝湖链接、业务路由和素材目录:
|
|
114
|
+
|
|
115
|
+
### 首次还原页面
|
|
116
|
+
|
|
117
|
+
```text
|
|
118
|
+
使用 lanhu-design MCP 还原并校验页面,默认只调用以下蓝湖工具:
|
|
119
|
+
lanhu_get_design_assets、lanhu_download_design_assets、lanhu_get_design_nodes。
|
|
120
|
+
|
|
121
|
+
蓝湖链接:https://lanhuapp.com/web/#/item/project/detailDetach?pid=28fa8ae2-50e3-47f9-a68e-5c18e8e69270&project_id=28fa8ae2-50e3-47f9-a68e-5c18e8e69270&image_id=e161f5ee-70f1-4da9-a61b-f6ac876e5eec&fromEditor=true
|
|
122
|
+
业务路由:/test-ui3
|
|
123
|
+
设计图及切图目录:src/assets/images/test-ui3
|
|
124
|
+
|
|
125
|
+
先获取切图列表,仅选择页面需要的设计师切图,按用途使用小写英文字母命名,
|
|
126
|
+
再下载同版本完整设计图及选定切图。读取设计节点时携带同一 versionId,
|
|
127
|
+
持续分页直到 hasMore=false。
|
|
128
|
+
结合项目已有组件和开发规范实现页面,并使用浏览器截图对照设计图进行校验。
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
上述三个工具负责获取设计数据和素材;页面实现与浏览器截图校验使用客户端的代码编辑、终端或浏览器能力。素材目录相对于目标项目,下载时应将其转换为 MCP 服务机器上的绝对路径。
|
|
132
|
+
|
|
133
|
+
### 当前稿缺少切图时复用参考稿素材
|
|
134
|
+
|
|
135
|
+
适用于公共素材只在其他设计稿中导出、当前稿没有重复切图的情况。跨稿查找由 AI 按以下要求组织,MCP 不自动进行图片匹配。
|
|
136
|
+
|
|
137
|
+
```text
|
|
138
|
+
使用 lanhu-design MCP 还原并校验页面,默认只调用:
|
|
139
|
+
lanhu_get_design_assets、lanhu_download_design_assets、lanhu_get_design_nodes。
|
|
140
|
+
|
|
141
|
+
主设计稿:https://lanhuapp.com/web/#/item/project/detailDetach?pid=065ef2b5-f4df-4079-90fe-f83bef7c7f8f&project_id=065ef2b5-f4df-4079-90fe-f83bef7c7f8f&image_id=3ed8639d-cd35-43ff-969d-18d835eb013d&fromEditor=true
|
|
142
|
+
业务路由:/test-ui5
|
|
143
|
+
设计图及切图目录:src/assets/images/test-ui5
|
|
144
|
+
参考素材设计稿:https://lanhuapp.com/web/#/item/project/detailDetach?pid=065ef2b5-f4df-4079-90fe-f83bef7c7f8f&project_id=065ef2b5-f4df-4079-90fe-f83bef7c7f8f&image_id=c1b4fcb9-4447-4fb4-bb08-8b360db7f48b&fromEditor=true
|
|
145
|
+
参考稿下载目录:src/assets/images/test-ui5/reference
|
|
146
|
+
|
|
147
|
+
执行要求:
|
|
148
|
+
1. 获取主稿切图列表并确定 versionId,后续主稿节点读取和素材下载均固定该版本。
|
|
149
|
+
2. 使用 lanhu_get_design_nodes 读取主稿节点,持续分页直到 hasMore=false。
|
|
150
|
+
3. 素材优先复用项目本地已有资源,其次使用主稿切图;仍缺少时,再从参考稿中查找。
|
|
151
|
+
4. 参考稿单独确定并固定自己的 versionId,不与主稿混用。
|
|
152
|
+
5. 结合图片内容、颜色、宽高比例、透明背景及清晰度确认素材是否匹配,不能仅凭图层名称判断;无法确认的列为待确认,不自行替换。
|
|
153
|
+
6. 仅下载所需切图,按用途使用小写英文字母命名。参考稿下载内容放入独立目录,避免与主稿完整设计图冲突。下载时将目录转换为 MCP 服务机器上的绝对路径。
|
|
154
|
+
7. 记录复用素材的来源设计稿、versionId、assetId 和本地路径。以主稿为准实现页面,完成构建及浏览器截图校验,只输出关键结果和剩余问题。
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### 根据最新设计稿局部更新页面
|
|
158
|
+
|
|
159
|
+
```text
|
|
160
|
+
使用 lanhu-design MCP,根据最新设计稿局部更新已有页面。
|
|
161
|
+
|
|
162
|
+
蓝湖链接:https://lanhuapp.com/web/#/item/project/detailDetach?pid=28fa8ae2-50e3-47f9-a68e-5c18e8e69270&project_id=28fa8ae2-50e3-47f9-a68e-5c18e8e69270&image_id=e161f5ee-70f1-4da9-a61b-f6ac876e5eec&fromEditor=true
|
|
163
|
+
业务路由:/test-ui3
|
|
164
|
+
更新范围:仅“服务说明”区域
|
|
165
|
+
设计图及切图目录:src/assets/images/test-ui3
|
|
166
|
+
|
|
167
|
+
工具调用要求:
|
|
168
|
+
1. 调用 lanhu_get_design_overview,不指定历史 versionId,获取当前最新版本,
|
|
169
|
+
定位目标区域的 nodeIds,并锁定返回的 versionId;后续调用均使用该版本。
|
|
170
|
+
2. 调用 lanhu_get_design_node_details,携带同一 versionId 和目标 nodeIds,
|
|
171
|
+
仅获取目标区域及必要子节点的详情;概览不能代替详细样式数据。
|
|
172
|
+
3. 检查 hasMore、truncated 和 warnings:按需翻页;存在深度裁剪时,
|
|
173
|
+
增加 maxDepth 或按子节点继续读取;对影响实现的缺失或不支持字段补读核实,
|
|
174
|
+
无法核实时说明限制,不将数据不完整视为校验通过。
|
|
175
|
+
4. 不调用 lanhu_get_design_nodes 获取全量详情。
|
|
176
|
+
5. 仅在需要新增或替换切图时调用 lanhu_get_design_assets 和
|
|
177
|
+
lanhu_download_design_assets,携带同一 versionId,仅选择目标区域所需切图,
|
|
178
|
+
按用途使用小写英文字母命名,并复用已有可用素材。
|
|
179
|
+
|
|
180
|
+
先检查现有实现,再依据节点数据更新目标区域的文案、样式和布局,
|
|
181
|
+
复用项目已有组件,其他区域保持不变。
|
|
182
|
+
完成后运行项目构建,并在对应业务路由进行目标区域的浏览器截图校验。
|
|
183
|
+
只输出关键结果:修改内容、构建结果、浏览器校验结果及未解决的问题;
|
|
184
|
+
未执行的校验需明确说明。
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
## 接入 SKILL 使用描述示例
|
|
189
|
+
|
|
190
|
+
### 创建新页面
|
|
191
|
+
|
|
192
|
+
```text
|
|
193
|
+
$design-to-code
|
|
194
|
+
使用 lanhu-design MCP,根据最新设计稿创建页面。
|
|
195
|
+
模式:create
|
|
196
|
+
蓝湖链接:<完整蓝湖页面链接>
|
|
197
|
+
业务路由:/test-ui3
|
|
198
|
+
设计图及切图目录:src/assets/images/test-ui3
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### 更新页面中某个部分
|
|
202
|
+
|
|
203
|
+
```text
|
|
204
|
+
$design-to-code
|
|
205
|
+
使用 lanhu-design MCP,根据最新设计稿局部更新已有页面。
|
|
206
|
+
模式:update
|
|
207
|
+
蓝湖链接:<完整蓝湖页面链接>
|
|
208
|
+
业务路由:/test-ui3
|
|
209
|
+
更新范围:仅“服务说明”区域
|
|
210
|
+
设计图及切图目录:src/assets/images/test-ui3
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
## 重要边界
|
|
214
|
+
|
|
215
|
+
蓝湖 Web 接口不是稳定公开 API,字段和路径可能变化。所有蓝湖相关字段都封装在 `src/lanhu/`,上层只依赖 `DesignNode`。第一次接入真实账号时,应根据浏览器 Network 中的实际响应补充适配器和测试夹具。
|
|
216
|
+
|
|
217
|
+
Cookie 等同于当前蓝湖账号权限:
|
|
218
|
+
|
|
219
|
+
- 不要写入源码、日志、MCP 返回值或 Git。
|
|
220
|
+
- 建议使用权限最小的专用账号。
|
|
221
|
+
- HTTP 模式默认只监听 `127.0.0.1`。
|
|
222
|
+
- HTTP 对外监听时默认必须配置 `MCP_AUTH_TOKEN`。本地使用建议保持默认监听地址,或使用 stdio 模式。
|
|
223
|
+
|
|
224
|
+
## 开发与调试
|
|
225
|
+
|
|
226
|
+
客户端安装及 stdio 配置见 [接入指南](TEAM_GUIDE.md)。以下内容用于本项目开发和协议调试。
|
|
227
|
+
|
|
228
|
+
安装开发依赖并检查项目:
|
|
229
|
+
|
|
230
|
+
```bash
|
|
231
|
+
nvm use
|
|
232
|
+
npm ci
|
|
233
|
+
npm run check
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
### stdio 开发运行
|
|
237
|
+
|
|
238
|
+
准备好本机 `.env` 后,在项目根目录执行:
|
|
239
|
+
|
|
240
|
+
```bash
|
|
241
|
+
node --env-file=.env --import tsx src/cli.ts --transport=stdio
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
此命令不自动监听源码变化。已在终端设置 `LANHU_COOKIE` 或在 `~/.config/lanhu-design-mcp/.env` 中填写时,也可执行 `npm run dev`。客户端及 Inspector 各自启动 MCP 子进程。
|
|
245
|
+
|
|
246
|
+
### 使用 MCP Inspector 浏览器调试
|
|
247
|
+
|
|
248
|
+
[MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) 提供浏览器界面,可以查看工具列表、填写参数并直接执行工具,不需要经过 AI 客户端。
|
|
249
|
+
|
|
250
|
+
#### 直接调试源码,无需 build
|
|
251
|
+
|
|
252
|
+
先在本项目根目录准备好 `.env` 并填写 `LANHU_COOKIE`,然后执行以下单行命令:
|
|
253
|
+
|
|
254
|
+
```bash
|
|
255
|
+
npx @modelcontextprotocol/inspector node --env-file=.env --import tsx src/cli.ts --transport=stdio
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
Inspector 会启动浏览器调试界面,并按给定命令启动 MCP 源码进程。浏览器没有自动打开时,打开终端打印的完整地址;若地址包含认证参数,保留完整参数,以实际输出为准。
|
|
259
|
+
|
|
260
|
+
stdio 模式由 Inspector 启动并连接自己的 MCP 子进程,不需要提前执行 `npm run dev`。如果之前已经手动运行了 `npm run dev`,可以先按 `Ctrl+C` 停止;那个手动进程不会被 Inspector 自动接管。
|
|
261
|
+
|
|
262
|
+
上面的命令通过 `--env-file=.env` 加载项目根目录的文件。Cookie 优先级从高到低是 CLI 的 `--cookie` 参数、进程环境变量、`--env-file` 指定的文件、`~/.config/lanhu-design-mcp/.env`。 [传参示例](TEAM_GUIDE.md#32-保存到本地-env)
|
|
263
|
+
|
|
264
|
+
#### 只启动 Inspector,再在界面配置
|
|
265
|
+
|
|
266
|
+
也可以在本项目根目录执行:
|
|
267
|
+
|
|
268
|
+
```bash
|
|
269
|
+
npx @modelcontextprotocol/inspector
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
打开终端提供的页面,新增或配置 stdio 连接。以下示例连接构建产物,需要先执行 `npm run build`:
|
|
273
|
+
|
|
274
|
+
| 配置项 | 值 |
|
|
275
|
+
| --- | --- |
|
|
276
|
+
| Transport Type | `STDIO` |
|
|
277
|
+
| Command | `node`,或本机 Node.js 的绝对路径 |
|
|
278
|
+
| Arguments | `--env-file=/absolute/path/lanhu-design-mcp/.env /absolute/path/lanhu-design-mcp/dist/cli.js --transport=stdio` |
|
|
279
|
+
|
|
280
|
+
将占位路径替换为本机项目绝对路径;路径包含空格时按界面的参数输入方式将其作为一个完整参数。点击 `Connect` 连接。界面名称可能随 Inspector 版本变化。
|
|
281
|
+
|
|
282
|
+
本项目需要 Node.js 20.19.0 或以上。使用 Inspector 时,Node.js 版本也要符合所用 Inspector 版本的 `engines` 要求。 [Inspector 项目说明](https://github.com/modelcontextprotocol/inspector)
|
|
283
|
+
|
|
284
|
+
#### 查看与测试工具
|
|
285
|
+
|
|
286
|
+
连接后进入工具页面(通常为 `Tools`),刷新或列出工具,预期只显示上文列出的 5 个工具。原来的 `lanhu_parse_url` 测试入口已注释;读取真实设计稿需要有效 Cookie 及项目权限。
|
|
287
|
+
|
|
288
|
+
测试新概览工具 `lanhu_get_design_overview` 时,使用真实设计稿链接:
|
|
289
|
+
|
|
290
|
+
```json
|
|
291
|
+
{"url":"<蓝湖设计稿链接>","maxDepth":2,"limit":100}
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
测试 `lanhu_get_design_node_details` 时,传入概览实际返回的 `versionId` 和节点 ID。全部工具参数见 [工具说明](docs/MCP_TOOLS_REFERENCE.md)。
|
|
295
|
+
|
|
296
|
+
修改源码后,在 Inspector 中断开并重新连接,使其重新启动源码进程;`tsx` 此启动方式不自动监听重启。使用 `dist/cli.js` 时需要先重新 build,再断开并重连。结束调试时断开连接,并在启动 Inspector 的终端按 `Ctrl+C`。
|
|
297
|
+
|
|
298
|
+
### HTTP 模式
|
|
299
|
+
|
|
300
|
+
需要通过本机 HTTP 连接 MCP 时,构建后在项目根目录启动:
|
|
301
|
+
|
|
302
|
+
```bash
|
|
303
|
+
npm run build
|
|
304
|
+
node --env-file=.env dist/cli.js --transport=http
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
开发调试可使用 `node --env-file=.env --import tsx src/cli.ts --transport=http`。配置已通过终端环境变量或 `~/.config/lanhu-design-mcp/.env` 提供时,也可执行 `npm run dev:http`。
|
|
308
|
+
|
|
309
|
+
默认端点:
|
|
310
|
+
|
|
311
|
+
```text
|
|
312
|
+
MCP: http://127.0.0.1:3100/mcp
|
|
313
|
+
Health: http://127.0.0.1:3100/health
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
如果配置了 `MCP_AUTH_TOKEN`,请求需要携带:
|
|
317
|
+
|
|
318
|
+
```text
|
|
319
|
+
Authorization: Bearer <token>
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
## 项目结构
|
|
323
|
+
|
|
324
|
+
```text
|
|
325
|
+
src/
|
|
326
|
+
├── cache/ # 无敏感数据落盘的短期内存缓存
|
|
327
|
+
├── design/ # DesignNode 解析与 Token 提取
|
|
328
|
+
├── http/ # HTTP MCP transport
|
|
329
|
+
├── lanhu/ # 蓝湖 Web 接口适配层
|
|
330
|
+
├── mcp/ # MCP Tool 注册
|
|
331
|
+
├── service/ # 应用服务编排
|
|
332
|
+
└── utils/ # URL 等通用逻辑
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
|
|
336
|
+
## 开发命令
|
|
337
|
+
|
|
338
|
+
```bash
|
|
339
|
+
npm run typecheck
|
|
340
|
+
npm test
|
|
341
|
+
npm run build
|
|
342
|
+
npm run check
|
|
343
|
+
```
|
package/dist/app.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { LanhuClient } from './lanhu/client.js';
|
|
2
|
+
import { DesignService } from './service/design-service.js';
|
|
3
|
+
export declare function createApplication(): {
|
|
4
|
+
config: import("./config.js").AppConfig;
|
|
5
|
+
dependencies: {
|
|
6
|
+
client: LanhuClient;
|
|
7
|
+
designService: DesignService;
|
|
8
|
+
};
|
|
9
|
+
};
|
package/dist/app.js
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { loadConfig } from './config.js';
|
|
2
|
+
import { LanhuClient } from './lanhu/client.js';
|
|
3
|
+
import { DesignService } from './service/design-service.js';
|
|
4
|
+
export function createApplication() {
|
|
5
|
+
const config = loadConfig();
|
|
6
|
+
const client = new LanhuClient(config.lanhu);
|
|
7
|
+
const designService = new DesignService(client);
|
|
8
|
+
return {
|
|
9
|
+
config,
|
|
10
|
+
dependencies: { client, designService },
|
|
11
|
+
};
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=app.js.map
|
package/dist/app.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO;QACL,MAAM;QACN,YAAY,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACxC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
export class MemoryCache {
|
|
2
|
+
ttlMs;
|
|
3
|
+
entries = new Map();
|
|
4
|
+
constructor(ttlMs) {
|
|
5
|
+
this.ttlMs = ttlMs;
|
|
6
|
+
}
|
|
7
|
+
get(key) {
|
|
8
|
+
const entry = this.entries.get(key);
|
|
9
|
+
if (!entry)
|
|
10
|
+
return undefined;
|
|
11
|
+
if (entry.expiresAt <= Date.now()) {
|
|
12
|
+
this.entries.delete(key);
|
|
13
|
+
return undefined;
|
|
14
|
+
}
|
|
15
|
+
return entry.value;
|
|
16
|
+
}
|
|
17
|
+
set(key, value) {
|
|
18
|
+
this.entries.set(key, {
|
|
19
|
+
expiresAt: Date.now() + this.ttlMs,
|
|
20
|
+
value,
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
clear() {
|
|
24
|
+
this.entries.clear();
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=memory-cache.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-cache.js","sourceRoot":"","sources":["../../src/cache/memory-cache.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,WAAW;IAGO;IAFZ,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IAElE,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;YAClC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}
|
package/dist/cli.d.ts
ADDED
package/dist/cli.js
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { loadEnvFile } from 'node:process';
|
|
5
|
+
import { serveStdio } from '@modelcontextprotocol/server/stdio';
|
|
6
|
+
import { createApplication } from './app.js';
|
|
7
|
+
import { startHttpServer } from './http/server.js';
|
|
8
|
+
import { createLanhuMcpServer } from './mcp/server.js';
|
|
9
|
+
import { saveUserCookie } from './user-cookie.js';
|
|
10
|
+
function readCookieArgument() {
|
|
11
|
+
const args = process.argv.slice(2);
|
|
12
|
+
const index = args.findIndex((arg) => arg === '--cookie' || arg.startsWith('--cookie='));
|
|
13
|
+
const argument = args[index];
|
|
14
|
+
if (argument === undefined)
|
|
15
|
+
return undefined;
|
|
16
|
+
const cookie = argument === '--cookie' ? args[index + 1] : argument.slice('--cookie='.length);
|
|
17
|
+
if (!cookie?.trim() || (argument === '--cookie' && cookie.startsWith('--'))) {
|
|
18
|
+
throw new Error('--cookie requires a non-empty value');
|
|
19
|
+
}
|
|
20
|
+
return cookie;
|
|
21
|
+
}
|
|
22
|
+
function readTransport() {
|
|
23
|
+
const argument = process.argv.find((value) => value.startsWith('--transport='));
|
|
24
|
+
const value = argument?.split('=', 2)[1] ?? process.env.MCP_TRANSPORT ?? 'stdio';
|
|
25
|
+
if (value !== 'stdio' && value !== 'http') {
|
|
26
|
+
throw new Error('transport must be stdio or http');
|
|
27
|
+
}
|
|
28
|
+
return value;
|
|
29
|
+
}
|
|
30
|
+
async function main() {
|
|
31
|
+
const envFile = join(homedir(), '.config', 'lanhu-design-mcp', '.env');
|
|
32
|
+
const cookie = readCookieArgument();
|
|
33
|
+
if (process.argv.slice(2).includes('--save-cookie')) {
|
|
34
|
+
await saveUserCookie(envFile, cookie);
|
|
35
|
+
console.error(`Lanhu Cookie saved to ${envFile}. Restart the MCP client to use it.`);
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
loadEnvFile(envFile);
|
|
40
|
+
}
|
|
41
|
+
catch (error) {
|
|
42
|
+
if (error.code !== 'ENOENT')
|
|
43
|
+
throw error;
|
|
44
|
+
}
|
|
45
|
+
if (cookie !== undefined)
|
|
46
|
+
process.env.LANHU_COOKIE = cookie;
|
|
47
|
+
const application = createApplication();
|
|
48
|
+
const transport = readTransport();
|
|
49
|
+
if (transport === 'stdio') {
|
|
50
|
+
const handle = serveStdio(() => createLanhuMcpServer(application.dependencies));
|
|
51
|
+
console.error('lanhu-design-mcp is listening on stdio');
|
|
52
|
+
process.on('SIGINT', () => void handle.close());
|
|
53
|
+
process.on('SIGTERM', () => void handle.close());
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const httpServer = await startHttpServer(application.config.http, application.dependencies);
|
|
57
|
+
console.error(`lanhu-design-mcp is listening on http://${application.config.http.host}:${application.config.http.port}/mcp`);
|
|
58
|
+
const shutdown = () => {
|
|
59
|
+
void httpServer.close().then(() => process.exit(0));
|
|
60
|
+
};
|
|
61
|
+
process.on('SIGINT', shutdown);
|
|
62
|
+
process.on('SIGTERM', shutdown);
|
|
63
|
+
}
|
|
64
|
+
main().catch((error) => {
|
|
65
|
+
console.error(error);
|
|
66
|
+
process.exitCode = 1;
|
|
67
|
+
});
|
|
68
|
+
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,MAAM,GAAG,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9F,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC;IACjF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACpD,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,yBAAyB,OAAO,qCAAqC,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,WAAW,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC;IAE5D,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAElC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5F,OAAO,CAAC,KAAK,CACX,2CAA2C,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAC9G,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
|
package/dist/config.d.ts
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export interface AppConfig {
|
|
2
|
+
lanhu: {
|
|
3
|
+
cookie?: string;
|
|
4
|
+
baseUrl: string;
|
|
5
|
+
ddsBaseUrl: string;
|
|
6
|
+
requestTimeoutMs: number;
|
|
7
|
+
cacheTtlMs: number;
|
|
8
|
+
};
|
|
9
|
+
http: {
|
|
10
|
+
host: string;
|
|
11
|
+
port: number;
|
|
12
|
+
authToken?: string;
|
|
13
|
+
allowUnauthenticated?: boolean;
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
export declare function loadConfig(): AppConfig;
|
package/dist/config.js
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
function readPositiveInteger(name, fallback) {
|
|
2
|
+
const raw = process.env[name];
|
|
3
|
+
if (!raw)
|
|
4
|
+
return fallback;
|
|
5
|
+
const value = Number(raw);
|
|
6
|
+
if (!Number.isInteger(value) || value <= 0) {
|
|
7
|
+
throw new Error(`${name} must be a positive integer`);
|
|
8
|
+
}
|
|
9
|
+
return value;
|
|
10
|
+
}
|
|
11
|
+
export function loadConfig() {
|
|
12
|
+
const cookie = process.env.LANHU_COOKIE?.trim();
|
|
13
|
+
const authToken = process.env.MCP_AUTH_TOKEN?.trim();
|
|
14
|
+
return {
|
|
15
|
+
lanhu: {
|
|
16
|
+
...(cookie ? { cookie } : {}),
|
|
17
|
+
baseUrl: process.env.LANHU_BASE_URL?.trim() || 'https://lanhuapp.com',
|
|
18
|
+
ddsBaseUrl: process.env.LANHU_DDS_BASE_URL?.trim() || 'https://dds.lanhuapp.com',
|
|
19
|
+
requestTimeoutMs: readPositiveInteger('LANHU_REQUEST_TIMEOUT_MS', 20_000),
|
|
20
|
+
cacheTtlMs: readPositiveInteger('LANHU_CACHE_TTL_MS', 300_000),
|
|
21
|
+
},
|
|
22
|
+
http: {
|
|
23
|
+
host: process.env.MCP_HOST?.trim() || '127.0.0.1',
|
|
24
|
+
port: readPositiveInteger('MCP_PORT', 3_100),
|
|
25
|
+
allowUnauthenticated: process.env.MCP_ALLOW_UNAUTHENTICATED === 'true',
|
|
26
|
+
...(authToken ? { authToken } : {}),
|
|
27
|
+
},
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgBA,SAAS,mBAAmB,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAE1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAErD,OAAO;QACL,KAAK,EAAE;YACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,sBAAsB;YACrE,UAAU,EACR,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,0BAA0B;YACtE,gBAAgB,EAAE,mBAAmB,CAAC,0BAA0B,EAAE,MAAM,CAAC;YACzE,UAAU,EAAE,mBAAmB,CAAC,oBAAoB,EAAE,OAAO,CAAC;SAC/D;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,WAAW;YACjD,IAAI,EAAE,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC;YAC5C,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM;YACtE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export interface SourceAsset {
|
|
2
|
+
assetId: string;
|
|
3
|
+
nodeId: string;
|
|
4
|
+
name: string;
|
|
5
|
+
kind: 'exported_asset' | 'render_fallback';
|
|
6
|
+
sourcePointer: string;
|
|
7
|
+
variants: Array<{
|
|
8
|
+
format: 'raster' | 'svg';
|
|
9
|
+
url: string;
|
|
10
|
+
}>;
|
|
11
|
+
bounds: Record<string, unknown>;
|
|
12
|
+
}
|
|
13
|
+
/** Only explicit image fields are resources; generic URLs are not cutouts. */
|
|
14
|
+
export declare function collectSourceAssets(source: unknown, versionId: string): SourceAsset[];
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
function record(value) {
|
|
3
|
+
return value && typeof value === 'object' && !Array.isArray(value)
|
|
4
|
+
? value : {};
|
|
5
|
+
}
|
|
6
|
+
function flag(value) { return value === true || value === 1; }
|
|
7
|
+
/** Only explicit image fields are resources; generic URLs are not cutouts. */
|
|
8
|
+
export function collectSourceAssets(source, versionId) {
|
|
9
|
+
const assets = [];
|
|
10
|
+
const visited = new Set();
|
|
11
|
+
const root = record(source);
|
|
12
|
+
const isPhotoshop = String(root.type ?? '').toLowerCase() === 'ps';
|
|
13
|
+
const exportedIds = new Set(Array.isArray(root.assets) ? root.assets
|
|
14
|
+
.map(record).filter(asset => flag(asset.isAsset) || flag(asset.isSlice))
|
|
15
|
+
.map(asset => String(asset.id)) : []);
|
|
16
|
+
const seenPhotoshopAssets = new Set();
|
|
17
|
+
function walk(value, pointer, inheritedHidden) {
|
|
18
|
+
if (!value || typeof value !== 'object' || visited.has(value))
|
|
19
|
+
return;
|
|
20
|
+
visited.add(value);
|
|
21
|
+
if (Array.isArray(value)) {
|
|
22
|
+
value.forEach((item, index) => walk(item, `${pointer}/${index}`, inheritedHidden));
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
const node = record(value);
|
|
26
|
+
const hidden = inheritedHidden || node.visible === false || node.isVisible === false || node.hidden === true;
|
|
27
|
+
for (const field of isPhotoshop ? ['images', 'ddsImages'] : ['image', 'ddsImage']) {
|
|
28
|
+
const image = record(node[field]);
|
|
29
|
+
const variants = [];
|
|
30
|
+
if (typeof image.imageUrl === 'string')
|
|
31
|
+
variants.push({ format: 'raster', url: image.imageUrl });
|
|
32
|
+
if (typeof image.svgUrl === 'string')
|
|
33
|
+
variants.push({ format: 'svg', url: image.svgUrl });
|
|
34
|
+
if (isPhotoshop && field === 'images') {
|
|
35
|
+
if (typeof image.png_xxxhd === 'string' && image.png_xxxhd)
|
|
36
|
+
variants.push({ format: 'raster', url: image.png_xxxhd });
|
|
37
|
+
if (typeof image.svg === 'string' && image.svg)
|
|
38
|
+
variants.push({ format: 'svg', url: image.svg });
|
|
39
|
+
}
|
|
40
|
+
if (isPhotoshop && field === 'ddsImages' && typeof image.orgUrl === 'string' && image.orgUrl) {
|
|
41
|
+
variants.push({ format: 'raster', url: image.orgUrl });
|
|
42
|
+
}
|
|
43
|
+
if (!variants.length || hidden)
|
|
44
|
+
continue;
|
|
45
|
+
// Photoshop may repeat the same layer under board and info.
|
|
46
|
+
const identity = `${String(node.id ?? pointer)}:${field}`;
|
|
47
|
+
if (isPhotoshop && seenPhotoshopAssets.has(identity))
|
|
48
|
+
continue;
|
|
49
|
+
if (isPhotoshop)
|
|
50
|
+
seenPhotoshopAssets.add(identity);
|
|
51
|
+
const sourcePointer = `${pointer}/${field}`;
|
|
52
|
+
const exported = isPhotoshop
|
|
53
|
+
? field === 'images' && (flag(node.isAsset) || flag(node.isSlice) || exportedIds.has(String(node.id)))
|
|
54
|
+
: field === 'image' && (flag(node.hasExportImage) || flag(node.exportable));
|
|
55
|
+
assets.push({
|
|
56
|
+
assetId: createHash('sha256').update(`${versionId}:${sourcePointer}`).digest('hex').slice(0, 24),
|
|
57
|
+
nodeId: String(node.id ?? pointer), name: String(node.name ?? node.id ?? 'asset'),
|
|
58
|
+
kind: exported ? 'exported_asset' : 'render_fallback', sourcePointer,
|
|
59
|
+
variants, bounds: record(node.frame ?? node.bounds ?? image.size),
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
// Source families use info, artboard.layers, board.layers or children.
|
|
63
|
+
for (const [key, child] of Object.entries(node)) {
|
|
64
|
+
if (['image', 'ddsImage', 'fills', 'style', 'images', 'ddsImages', 'assets'].includes(key))
|
|
65
|
+
continue;
|
|
66
|
+
walk(child, `${pointer}/${key.replace(/~/g, '~0').replace(/\//g, '~1')}`, hidden);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
walk(source, '', false);
|
|
70
|
+
return assets;
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=assets.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/design/assets.ts"],"names":[],"mappings":"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"}
|