return_rp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@return_rp 做一个观鸟 App,包含探索页和手记页,验证跳转后导出可编辑的 .rp"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
给 AI 一张自由画布。把设计带回 Axure。
用 RP/1 写下设计,让 AI 起稿、你来精修,交付可继续编辑的 .rp。
Axure RP 9 / RP 11 · AI 原生画布 · CLI 与 MCP
开始使用 · 30 秒了解 · Studio · RP/1 · 版本对齐 · 常见问题 · English
00 30 秒了解 return_rp
一句话:把截图、需求描述或 RP/1 源码,变成可继续编辑的 Axure 原生工程,而不是一张原型截图。
你给它 | 它交给你 |
一张截图、一段需求、一份 PRD,或一份 RP/1 源码 | 原生 |
AI 起稿,人来定稿:
AI 起稿 | 人来精修 | 原生交付 |
用自然语言或 RP/1 生成多页流程,按图层与语义局部改稿。 | 在 Studio 里双击改字、框选、拖拽、测距、撤销重做。 | 文字、按钮与输入框保持独立元件,在 Axure 中继续编辑。 |
它不是又一个 UI 生成器:
对比项 | 多数截图转代码工具 | return_rp |
输出物 | HTML、图片或不可编辑稿 | 原生 |
设计源码 | 一次性生成,难以 diff 与回改 | RP/1 文本源码,可版本管理、按图层局部修改 |
Agent 协作 | 往往只能整页重来 | 按图层、语义与范围查询,改具体对象 |
Axure 版本 | 通常只覆盖一个版本 | RP 9 / RP 11 双向能力对齐 |
验证方式 | 看截图 | 结构检查 + 浏览器交互 + Axure 保存重开 / 预览 |
Related MCP server: protoflow
01 一条链路,从想法到 Axure。
把意图写成源码。 截图走临摹管线,需求与 PRD 直接写成 RP/1;页面、组件、变量、交互都在同一份文本里。
在画布里推敲。 Agent 搭第一版,你直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。
在交付前验证。 真实截图、交互场景、结构检查分别运行,确认跳转、状态与保存回显。
带回 Axure。 生成原生工程,或导出浏览器可运行版本;继续编辑、继续迭代。
02 在画布里,把设计推敲到位。
Studio 是一块 AI 和人都能编辑的自由画布。让 Agent 搭好第一版,再直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。
AI 起稿。 RP/1 或命令创作,按图层、语义和范围查询,局部改稿。 人来精修。 双击改字、Shift 框选、Option / Alt 悬停测距,撤销重做。 一起验证。 查看真实截图、运行交互场景,再交付原型。
03 设计意图,有自己的源码。
RP/1 把页面、布局、组件、变量和交互写在一起。AI 改动有明确目标,设计也能保留结构、版本和继续迭代的起点。
rp/1 target=9 name="下一次相遇" domain=mobile theme=mobile-hifi
page #home name="发现" device=iphone-17-pro
phone-shell #shell title="去自然里,遇见飞羽。" gap=16
card #bird [fillxhug] title="今天,认识一只翠鸟" body="从水边的一抹蓝绿,开始你的观鸟手记。" actionText="记下这次遇见" goto="notes"
page #notes name="手记" device=iphone-17-pro
phone-shell #shell title="我的第一篇手记" gap=16
input #note [fillx44] value="今天在水边遇见了它。"
button #back [fillx44] "返回发现" goto="home"从一个页面到完整流程,revise_prototype 继续改稿;已有原生修改也能在支持范围内合并回源码。
04 交到 Axure,仍然握得住设计。
生成原生 .rp,在 Axure 中继续修改支持的文字、控件和布局。页面、变量、动态面板与跳转可以一起交付,源稿、预览和检查报告也一并保留。
从哪里继续 | 可以做什么 |
Studio | 和 AI 共用设计文档、事务与撤销历史 |
Axure | 打开原生工程,继续编辑元件与支持的交互 |
浏览器 | 运行预览;也可导出独立 HTML / CSS / JS |
交付物 | 说明 |
原生 | 默认目标 RP 11; |
浏览器预览 | 真实交互场景,可复现点击、跳转与状态变化 |
代码导出 | 独立 HTML / CSS / JS,便于评审或嵌入 |
结构与验收报告 | 三零检查(未解析记录、悬空引用、问题数均为 0)、浏览器断言与 Axure 往返结果分开记录 |
05 RP 9 与 RP 11,走同一条流水线。
两个版本共用同一套 CLI、MCP 与 Studio。任一版本能做的事,另一版本不会以 unsupported 收场;缺口必须登记,并在运行时告警或写入前明确诊断,绝不静默丢参数。
能力 | RP 9 | RP 11 |
RP/1 原生编译与场景写入 | 支持 | 支持 |
空白模板检测、裁剪与动态面板克隆 | 支持 | 支持 |
原生表单控件与状态样式 | 支持 | 支持 |
原生中继器与数据操作 | 支持 | 支持 |
核心交互、动作与自适应视图 | 支持 | 支持 |
Studio 局部 RP/1 创作 | 支持 | 支持 |
自动 Axure 预览(Swift / PowerShell 宿主) | 支持 | 支持 |
图片离线生成原生工程 | 支持 | 支持 |
已登记的边界集中在以下几处:RP 11 没有面板注册链模型;RP 9 的缩放锚点、切换启用、应用样式与 RP 11 专属事件/函数没有对应结构,写入前显式诊断;RP 9 的过滤组合类型与按行号删除中继器行按等价规则改写,标记为部分支持。
开始使用
依赖 | 版本 | 用途 |
Node.js | 18+ | CLI、MCP、Studio 与测试 |
Python | 3.10+ | 原生编译与图片处理 |
Axure | RP 9 或 RP 11 | 原生生成、保存重开与自动预览(可选) |
git clone https://github.com/karlmoriaty/AxurePR-return-rp.git
cd AxurePR-return-rp
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
npm ciWindows PowerShell:
git clone https://github.com/karlmoriaty/AxurePR-return-rp.git
cd AxurePR-return-rp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
npm ci也可以直接从 Releases 下载 return_rp-<version>-share.zip,解压后在目录内执行 npm ci --ignore-scripts。分享包不含测试与私有素材;原生生成仍需要本机 Axure 和一份你自己保存的空白工程。
只用 CLI / MCP 时,也可以直接从 npm 运行,无需克隆仓库(原生生成与图片处理仍需要上面的 Python 依赖):
npx -y -p return_rp return_rp --help
npx -y -p return_rp return_rp-mcpMCP 客户端配置可以直接写 "command": "npx", "args": ["-y", "-p", "return_rp", "return_rp-mcp"]。
MCP 工具列表依赖可选依赖
@modelcontextprotocol/sdk(npm ci会一并安装)。只跑 CLI 不装也能用;缺少依赖时 MCP 启动会提示在项目目录执行npm ci --ignore-scripts,而不是静默返回空工具列表。
将下面的绝对路径换成自己的安装目录、Python 环境和空白工程:
{
"mcpServers": {
"return_rp": {
"command": "node",
"args": ["/absolute/path/AxurePR-return-rp/bin/mcp.mjs"],
"env": {
"PATH": "/absolute/path/AxurePR-return-rp/.venv/bin:/usr/local/bin:/usr/bin:/bin",
"AXURE_BLANK_TEMPLATE_RP9": "/absolute/path/my-rp9-blank.rp",
"AXURE_BLANK_TEMPLATE_RP11": "/absolute/path/my-rp11-blank.rp"
}
}
}
}PATH 应包含安装了依赖的 Python;Node 不在默认路径时,command 也使用绝对路径。空白工程用你自己在对应版本 Axure 中保存的单页文件;只用一个版本时,保留对应的 AXURE_BLANK_TEMPLATE_RP9 / RP11 即可。安装更新后重新连接 MCP。
接好后,调用 studio_open_project,在浏览器打开返回的 url:
{ "projectDir": "/absolute/path/my-first-prototype" }然后把任务交给 Agent:
做一个观鸟 App,包含探索、鸟种详情和手记。先在画布里设计,验证跳转和保存回显,再导出可编辑的
.rp。
Agent 从 studio_describe({"topic":"workflow"}) 开始。导入已有 RP/1 可为 studio_open_project 指定 sourcePath;完整原生生成使用 generate_prototype。截图临摹走 generate_from_image 或 scripts/trace.mjs,局部创作和完整编译的支持范围分别记录。
原生生成默认目标 RP 11,也可用 target=9 或 AXURE_TARGET_VERSION=9 切到 RP9。宿主证据覆盖 macOS + Axure RP9,以及 Windows + Axure RP9 / RP11(GUI 保存重开与预览往返)。部分效果采用嵌入位图,字体和预览可能受宿主影响。任意小数缩放清晰度、单画板海量节点仍有边界。
结构检查、浏览器行为与 Axure 保存重开分别验证。能力范围 · RP9 / RP11 能力对齐 · 验收层级 · 故障排查
常见问题
不必须。只使用 Studio、浏览器预览或代码导出时,Node.js 与 Python 依赖就够了。生成原生 .rp、离线图片工程、保存重开与自动预览需要本机 Axure;首次使用请自己保存一份单页空白工程,并通过 AXURE_BLANK_TEMPLATE_RP9 / AXURE_BLANK_TEMPLATE_RP11 指定。
可以。Windows 走 PowerShell 宿主,RP 9 / RP 11 都已实测打开、保存命令、关闭、重开与预览;macOS 走 Swift 宿主。GUI 相关能力需要桌面会话和本机 Axure,无桌面会话的服务器环境只能使用非 GUI 部分。
通常是缺少可选依赖 @modelcontextprotocol/sdk。在项目目录执行 npm ci --ignore-scripts,重启或重连 MCP 客户端。启动时会给出明确提示,不会静默返回空列表。
Axure 对未修改的文档可能跳过写盘。此时宿主如实返回 saved: false,并单独记录 saveCommandIssued: true;任务验收以保存命令已执行为准,是否真正写入由文件 mtime 判断。这比把保存键一律当成成功更接近真实行为。
文字、按钮、输入框与布局会写成独立原生元件,支持的交互一起交付。部分视觉效果使用嵌入位图;字体、预览与渲染受宿主影响;任意小数缩放的清晰度、单画板海量节点也有边界。建议按「结构检查 → 浏览器行为 → Axure 保存重开」三层分别验收。
默认 RP 11。需要 RP 9 时在 RP/1 头部写 target=9,或设置 AXURE_TARGET_VERSION=9。两个版本共用同一批 CLI / MCP 工具。
项目结构
目录 | 作用 |
|
|
| RP/1 编译、原生装配、宿主往返、截图临摹与发布工具 |
| Studio 画布前端与本地服务 |
| RP/1 语言、能力边界、工作流与故障排查手册 |
| 可直接运行的 RP/1 与场景示例 |
| 结构、浏览器、版本对齐与跨平台回归 |
| 设计流程、验收层级与版本对齐说明 |
Node 源码以 TypeScript(*.mts / studio/web/*.ts)编写,npm run build 生成同路径 .mjs / .js;仓库与发布包同时包含源码和生成后的运行时文件,直接使用不需要先构建。
Agent Skill / 贡献指南 / 变更记录 / Releases / MIT License
问题反馈
原作者 / 维护者:karlmoriaty(GitHub:github.com/karlmoriaty)
问题反馈:GitHub Issues 或 QQ 邮箱:3070687583@qq.com
如果这个项目帮你省下了画原型的时间,欢迎 Star、分享给同事,或带着真实案例来提 Issue。
由 karlmoriaty 独立开发 · 与 Axure 无隶属关系 · 第三方案例照片按各自许可与署名使用
Available Tools
87 toolsadd_adaptive_viewA
为页面写入自适应视图集(Base+子视图)并按视图覆盖元件尺寸位置。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node add-adaptive-view.mjs <src.rp> <out.rp> [断点宽度...] [--override "<视图名>:<元件名>:w=<宽>[,h=<高>][,x=,y=]"]
Inputs: args (required), session.
add_click_linkB
给无交互的具名元件添加点击打开链接交互(capabilities.md 未列此工具,仅结构级)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node add-click-link.mjs source.rp output.rp widgetName url [current|new]
Inputs: args (required), session.
add_interactionA
向元件或页面追加事件+动作交互(支持 --replace-event、--on-page、--json 条件/多 Case;FCall 函数名按 18 项注册表白名单校验)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node add-interaction.mjs source.rp output.rp <widgetName|pageName> [--page] [--on-page ] [--replace-event] --event --action [key=value ...]
axure_openB
开启编辑会话:红线检查源 .rp → 复制出工作副本链[0](与源同目录,源主名.work-1.rp)→ 返回总览(页面清单/元件数/交互数、全局变量、母版、结构三零)。每连接一个会话;再次 open 换源重建。
Inputs: rp, file, path, rpFile.
axure_saveA
链尾另存为交付文件(白名单+防覆盖,只写新文件),返回绝对路径与 SHA-256;省略 as 时返回链尾现状(路径/SHA/三零)。
Inputs: as.
axure_stateARead-only
当前会话快照(缓存摘要;重新检查磁盘用 verify):源文件、工作副本链全部节点、timeline、链尾结构三零。上下文被压缩后用一次调用恢复状态。
Inputs: no named parameters.
axvg_buildB
把布局规格 JSON 展开为完整 Axvg JSON(几何/样式编码)。 登记证据 channel-a,只适用 capabilities.md 的已验样本。CLI: node axvg.mjs build <spec.json> -o <out.axvg.json>;args 省略子命令词,服务自动加入。
Inputs: args (required).
axvg_pasteA
把 Axvg JSON 写入剪贴板并触发 Axure 粘贴上画布(宿主按 --version / --bundle-id 显式绑定)。 登记证据 channel-a,只适用 capabilities.md 的已验样本。CLI: node axvg.mjs paste <file.axvg.json> [--no-menu] [--version 9|11] [--bundle-id ];args 省略子命令词,服务自动加入。
Inputs: args (required).
axvg_selftestBRead-only
内置几何/编码断言自检,不产出文件。 登记证据 channel-a,只适用 capabilities.md 的已验样本。CLI: node axvg.mjs selftest;args 省略子命令词,服务自动加入。
Inputs: args (required).
clone_library_page_contentA
把 .rplib 库页的全部内容闭包导入目标 .rp 页面。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node clone-library-page-content.mjs <source.rplib> <target.rp> <output.rp> [--x N --y N]
Inputs: args (required), session.
clone_library_widgetA
从 .rplib 克隆单个原生控件到目标 .rp 页面。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node clone-library-widget.mjs <source.rplib> <target.rp> <output.rp> [--x N --y N --w N --h N]
Inputs: args (required), session.
clone_native_connectorA
克隆原生 Connector 与端点闭包到目标页面(支持自定义锚点 GUID/坐标/方向保留及 PanelState 源图,跨 diagram 端点拒绝)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node clone-native-connector.mjs <source.rp> <target.rp> <output.rp> [options-json]
Inputs: args (required), session.
create_blank_pageA
把与输入文件同版本的空白模板 Page 记录追加到已有 .rp 生成新空白页(跨版本模板会拒绝)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node create-blank-page.mjs <input.rp> <output.rp>
Inputs: args (required), session.
create_blank_projectA
复制用户本机的 RP 9 / RP 11 原生空白模板生成单页空白 .rp 工程(模板按目标版本绑定)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 loaded,只适用 capabilities.md 的已验样本。CLI: node create-blank-project.mjs <output.rp> [--version 9|11]
Inputs: args (required), session.
create_global_variableA
创建具名全局变量及字符串默认值(离线结构级)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node create-global-variable.mjs <source.rp> <output.rp> [--default-value "Value"]
create_masterA
复制已有 Axure:Master 记录并注册为新命名的母版。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 preview,只适用 capabilities.md 的已验样本。CLI: node create-master.mjs <source.rp> <output.rp>
Inputs: args (required), session.
create_panel_cloneA
克隆真实模板离线创建动态面板并插入状态包。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node create-panel-clone.mjs <src.rp> <out.rp> [state...] [--x N --y N --w N --h N] [--page-index N]
Inputs: args (required), session.
diagnose_prototypeBRead-only
只读诊断 RP/1;收集独立节点错误并给出页面/元件/字段、源码行列、当前值及可审查补丁。依赖检查未完成时明确标记;不自动改源码。
Inputs: source (required), limit.
duplicate_pageA
按页名(或 --index 记录号)复制已有页面生成新页。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node duplicate-page.mjs source.rp output.rp sourceName newName
Inputs: args (required), session.
edit_textA
改一个元件的文字:定位(唯一匹配或 locate 定位字段;多匹配报错列候选)→ 经 set-widget-text / set-widget-richtext 库导出写新链节点 → 新节点过 rp-read 三零(失败则坏节点保留 .rejected、链回退并报差异)。text=简单文本;richRuns=富文本段落/runs,可含段落行距、原生列表级别(list)、wrapping/trimming 及链接目标。edits 数组一次批量改多个元件,全部成功才提交,任一失败整批回退。返回逐条 before/after 与新链尾;GUI/预览需另验。
Inputs: page, text, edits, target, +2 more.
explain_bindingARead-only
解释 RP/1 文字或进度条绑定的完整表达式、依赖、初始值、实际编译出的刷新事件和显示精度。静态编译关系,不冒充原生运行观测。重名用 page/id 或源码指针。
Inputs: source (required), target (required).
fill_panel_stateA
把一个 Page 的控件闭包导入 Page 或 Master 所属 PanelState(支持 --master、--append/--replace、嵌套面板/中继器/母版/连接线自定义锚点及闭合内部交互)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node fill-panel-state.mjs <source.rp> <target.rp> <new.rp> [--master] [--append | --replace]
generate_from_imageA
高层图片转原型入口:从本地 UI 截图(或已提取的分层 spec)自动执行 Apple Vision OCR、几何卡片/分割线/图标媒体切片识别、可选文案替换(replace),并在 RP9 / RP11 下离线直接写出真实可编辑二进制 .rp(文字、矩形、卡片、圆、分割线为独立原生元件,复杂矢量/图表/裁剪媒体为独立透明 PNG ImageBox,素材持久保存在 .assets 目录),同时记录 .baseline.json 与分层校验摘要。
Inputs: output (required), page, spec, image, +7 more.
generate_prototypeA
一次生成完整单页/多页原生 RP9 原型:spec 直接传 RP/1 结构化页面(或 .rp1/.json 文件路径)、共享 theme/palette/components、variables 与交互,自动编译、装配和检查跨页引用及事件覆盖,并记录 .baseline.json 共同基线;无需装配脚本。若提供 baseRp 且检测到原生已改稿,自动按 prefer 执行三方合并或冲突保护。output 为 .rp 路径(相对路径基于 AXURE_WRITE_ROOT 或当前工作目录解析)。
Inputs: output (required), spec, async, baseRp, +11 more.
gui_roundtripA
复制到新文件后在 Axure RP 9 或 RP 11 保存、关闭、重开(宿主按 version 或源文件版本绑定;macOS 走 Swift 宿主,Windows 走 PowerShell 宿主);可选传 preview=true 在重开后触发预览并校验本地预览地址。默认立即返回 job 句柄。
Inputs: output (required), source (required), wait, preview, +1 more.
inspectARead-only
单元件深看:富文本段落/runs 明细(字体/字号/样式/颜色/链接目标)、几何、交互树人类可读展开。target 接受 locate 返回的定位字段(也可直接在顶层传 query/name/page/record/id);可选传 path/rp/file 直接只读查看指定 .rp。
Inputs: id, rp, file, name, +8 more.
jobs_cancelA
取消排队或运行中的 job。已复制/保存的文件保留,不撤销已执行的 GUI 步骤。
Inputs: id (required).
jobs_getB
读取 job 状态、输出路径和分层验证结果。
Inputs: id (required).
jobs_listB
列出此 MCP 服务的 jobs;服务关闭后句柄失效。
Inputs: no named parameters.
list_custom_stylesBRead-only
列出文件已有原生自定义样式及 GUID(不创建样式)。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node custom-styles.mjs <source.rp|source.rplib>
locateARead-only
按名称或显示文本子串搜全文档元件(可选 page/type 过滤),覆盖页面顶层与面板状态/中继器行模板内元件;返回候选(page、record、对象 id、guid、name、text 摘要、type、容器路径),默认最多 50 项,limit/offset 分页并返回 total/hasMore/nextOffset。可选传 path/rp/file 直接只读查询指定 .rp(不建 .work 副本)。把 record+id(嵌套再加 container)喂给 inspect/edit_text,或 set_widget_text 的 --record/--widget。
Inputs: rp, file, page, path, +5 more.
name_widgetA
按旧名称快捷改名(可加页名),或按记录/对象 ID 精确改名;保留身份与交互。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 preview,只适用 capabilities.md 的已验样本。CLI: node name-widget.mjs <source.rp> <new.rp> --name --to [--page ];或 --record --widget --to ;兼容 <pageRecordsIndex|页名> [...]
Inputs: args (required), session.
patch_link_windowB
字节级改写唯一 Page 记录里链接打开方式 current/new(capabilities.md 未列,仅结构级研究工具)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node patch-link-window.mjs <source.rp> <new.rp> <current|new>
Inputs: args (required), session.
patch_stringB
替换唯一 Page 记录中的一个已有字符串(研究用,capabilities.md 未列)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node patch-string.mjs <source.rp> <new.rp>
Inputs: args (required), session.
place_masterA
在指定页面上放置母版实例(ReferenceDiagramObject)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node place-master.mjs <src.rp> <out.rp> [--x N --y N]
Inputs: args (required), session.
preview_prototypeA
在已有 ego lite 任务空间中验证真实 Axure 预览。按逻辑 ID 点击、输入并断言文字/变量/面板状态,返回实际状态、源码位置及报告截图。需要先运行 gui_roundtrip(preview:true) 或发布 HTML;不接管用户空间,不把模拟当原生证据。
Inputs: steps (required), output (required), source (required), spaceId (required), +3 more.
prototype_recipeCRead-only
查看三套完整创作范例、RP/1 零算高语法速查表(cheatsheet/tokens/gotchas)、推荐修改入口和可直接调用的生成参数;不写文件。
Inputs: recipe, includeSource.
read_interactionsARead-only
读取完整事件/Case/动作树。分页以统一 items 为准,包含页面事件、顶层元件、嵌套元件和母版;offset 是跳过的拥有者数,returned 是本次条数。contained 仅为嵌套元件的兼容视图,为空不代表本页没有交互。默认 limit=20,响应接近 20KB 时减少条数,按 nextOffset 继续;支持 page/widget(逻辑 ID、原生名称或对象 ID)过滤,可传 path/rp/file 只读查看 .rp。
Inputs: rp, file, page, path, +4 more.
rebind_widgetsA
筛选元件并批量绑定文件中已有原生样式;可显式清除局部样式覆盖。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node rebind-widgets.mjs <source.rp|rplib> <output.rp|rplib> <selector.json> [--reset-overrides]
remove_interactionA
按事件类型移除活动事件,或按 Case/Action 序号移除单个活动动作。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node remove-interaction.mjs source.rp output.rp <widgetName|pageName> [--page] [--on-page ] --event (--remove-event | --remove-action --case-index --action-index )
Inputs: args (required), session.
remove_panel_state_contentB
按顶层元件名删除、--ids 按 ID 删除或 --all 清空一个 PanelState。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node remove-panel-state-content.mjs source.rp new.rp [--master] (--all | --ids ... | ...)
Inputs: args (required), session.
rename_custom_styleA
按样式身份级联改名,更新所有记录的 MatchInfo 与 StyleCache 名称。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node rename-custom-style.mjs <source.rp|rplib> <output.rp|rplib>
rename_widgetA
快捷改名:target 为名称/文本或 locate 的 record+id,name(或 newName)为新名称;edits 可批量修改。覆盖页面、面板状态、中继器模板和母版定义。只改元件名,保留文字、身份与交互;允许重名,目标歧义时返回候选。全部成功后提交一个新链节点。
Inputs: name, page, edits, target, +2 more.
review_image_structureARead-only
只读审阅图片重建的 trace spec:列出卡片分组、重复结构、文字层级、共享样式及不可编辑图片/待校对文案。结果是带源码指针的候选,不推测交互或自动改层级。
Inputs: spec (required), limit.
revise_prototypeA
一次完成最小源码改稿、原生漂移检查、三方合并、原型生成和共同基线。支持逻辑 ID + property、结构节点增删改(add-node/remove-node/replace-node,value 支持直接传 .rp1 片段或 JSON)或 JSON Pointer 操作;output 省略或传 "auto" 时自动递增生成 -v2.rp;保留输入,输出新的源码与 .rp。冲突默认拒绝,dryRun 只返回影响。
Inputs: rp (required), source (required), operations (required), async, +7 more.
rp_readARead-only
只读解析 .rp 输出页面/元件/交互摘要或 JSON(含 dangling refs 检查)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 structure,只适用 capabilities.md 的已验样本。CLI: node rp-read.mjs <file.rp> [--json] [--full]
runtime_infoARead-only
读取活动 MCP 版本、启动实现指纹、磁盘差异、工具清单指纹及 RP9 模板可用性;判断是否需要重新连接服务。
Inputs: no named parameters.
set_combobox_optionsA
设置唯一原生 ComboBox 的选项与选中项。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-combobox-options.mjs <source.rp> <output.rp> [--selected ]
Inputs: args (required), session.
set_connector_anchorsA
在同一 Page 或 PanelState 记录内把连接线端点挂接到元件或脱开为自由端。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-connector-anchors.mjs <source.rp> <output.rp>
Inputs: args (required), session.
set_listbox_optionsB
设置唯一原生 ListBox 的选项、多选与选中索引。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-listbox-options.mjs <source.rp> <output.rp> [--selected ] [--single]
Inputs: args (required), session.
set_master_overridesA
按实例 ID 创建/更新/清除母版实例的文字覆盖或写入内嵌 PNG,不改共享定义。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-master-overrides.mjs source.rp new.rp overrides.json
Inputs: args (required), session.
set_native_tableA
改写原生 Table 矩阵/行高/列宽,扩容时克隆单元格,格支持 {runs} 多 run;可选用同页 VectorShape 模板生成视觉合并覆盖块。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-native-table.mjs input.rp output.rp table.json
Inputs: args (required), session.
set_panel_fit_to_contentA
按记录/元件 ID 写 native boolean fit-to-content 开关。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-panel-fit-to-content.mjs source.rp new.rp spec.json
Inputs: args (required), session.
set_widget_geometryA
快捷修改元件几何位置与尺寸(x、y、w/width、h/height):定位(target 或 widget+page)→ 更新二进制 MyStyle 坐标与尺寸(DOAName 3221225573 / 3221225577)→ 写新链节点并校验三零。支持单条或 edits 批量修改,改动可被 sync_prototype(lift/merge) 自动导回 RP/1 源码。
Inputs: h, w, x, y, +6 more.
set_widget_richtextA
整段重写原生 RichTextBlock 的段落与 runs(字体/字号/行距/对齐/原生列表级别/wrapping/trimming 及 run 全量键)。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-widget-richtext.mjs source.rp new.rp richtext.json
Inputs: args (required), session.
set_widget_styleA
快捷修改元件视觉样式(fill 背景色、stroke 边框色、color 文字颜色、radius 圆角):定位(target 或 widget+page)→ 更新二进制 MyStyle(DOAName 3221225479 / 3221225480 / 3221225478 / 3221225543)及富文本 Run 颜色 → 写新链节点并校验三零。颜色支持 #RRGGBB 或 #RRGGBBAA;改动可被 sync_prototype(lift/merge) 自动导回 RP/1 源码。
Inputs: fill, page, color, edits, +4 more.
set_widget_textA
按页内名称、记录索引+对象 ID 或容器路径精确定位改写一个既有文本片段。具名调用省略宿主源/输出即使用会话链;原始 args 用 session:true 并省略这两个参数(多源工具保留导入源)。显式路径不推进链。 登记证据 gui-roundtrip,只适用 capabilities.md 的已验样本。CLI: node set-widget-text.mjs <source.rp> <output.rp>
studio_apply_commandsA
提交同一权威文档的原子修改。commands或rp1片段二选一;rp1需要sourceMode:insert/update和pageId,显式字段增量更新、省略内容保留,支持行列号诊断。editNodes按role/within批量改稿;精确参数用studio_describe按需发现。强校验版本、幂等、WAL与撤销。
Inputs: baseRevision (required), idempotencyKey (required), rp1, url, +17 more.
studio_capture_screenshotBRead-only
严格等待指定 revision 在真实浏览器完成字体与图片渲染后截取画板或节点 PNG,返回 revision、contentHash 与文件 SHA-256。
Inputs: url, port, nodeId, pageId, +5 more.
studio_describeBRead-only
按需发现AI创作流程、RP/1、命令schema与craft指导。topic:command用name或names;fields/operation/surface仅用于topic:node。节点用name+fields查询;源码许可与真实生效验证分开登记。无需打开工程。
Inputs: name, names, topic, fields, +5 more.
studio_design_anchorsB
把项目里已认可的页面提炼成"排版配方"锚点(字阶/栅格/留白/色相/主次比),并让其它页面与锚点比对给出偏离量。语料是本地历史页面而不是互联网美图:这才是这个产品自己的参照系。action=extract 写入设计锚点文件,list 读取,compare 对比某页。
Inputs: action (required), url, mode, port, +5 more.
studio_design_content_planBRead-only
内容脚手架:找出"只有结构没有文案"的位置(空态、口号式大标题),给出需要的槽位、可套用模板与示例,以及一条可直接提交的 applyWith 命令。它不假装会写好文案——只把"该说清什么"变成可填的空。
Inputs: url, port, pageId, projectDir.
studio_design_exploreARead-only
批量生成设计变体并按可复现判据自动收敛:在密度/字阶/圆角/配色四条轴上展开组合,对每个变体计算同一套 L1 指标与反 slop 规则,按「未达标项 → 硬伤 → 提示 → 改动量」排序,返回入选变体可直接提交的 commands。也可传 candidates/baseRevision/states,隔离预演 AI 自写的任意构图命令,返回真实浏览器多状态联系图,默认保留内容和交互。不改源文档,不自动代选审美。
Inputs: url, axes, port, async, +8 more.
studio_design_fix_planARead-only
把度量发现的问题翻译成可直接提交的命令:栅格位置吸附、热区补足、为未绑定的列表补空态、把被撑高的文字框回缩。只开确定性处方(可计算、无需品味判断),不自动提交;字阶/配色/构图等取舍类问题交给 studio_design_explore 与锚点对比。
Inputs: url, port, pageId, projectDir.
studio_design_metricsBRead-only
计算页面的 L1 视觉完成度代理指标(字阶比、4px 栅格一致性、留白占比、文本对比度、主色相数)与反 AI-slop 负样本规则(等距三卡、紫渐变、空洞居中标题、图标圆角方块、首屏无素材、圆角过度)。每条 slop 规则的触发阈值随结果 slopRules 返回——未命中可能只是样本低于阈值,不代表规则失效。不返回审美总分:只给可复现的结构判断与具体改法。
Inputs: url, port, pageId, pixelTruth, +2 more.
studio_design_pixel_contrastBRead-only
像素对比度:用真实浏览器原图、隐藏字形底图和字形掩膜,逐笔画测量对比度;支持非整数DPR。描边、重叠文本和缺失证据显式unknown且不通过。
Inputs: dpr, url, port, pageId, +1 more.
studio_export_codeB
从当前权威快照导出独立可运行 HTML/CSS/JS 代码工程包(含源码、资源闭包、版本绑定 manifest.json 与运行说明 README.md),复用语义源布局、变量、动态面板、导航、中继器与矢量路径,显式列明并禁用未支持交互。支持 baseRevision 校验与 async:true 持久操作。
Inputs: url, port, async, outDir, +4 more.
studio_export_rpA
从当前权威快照导出原生.rp与逐节点兼容报告。baseRevision指定时必须仍为当前版。async:true加requestKey/baseRevision返回持久句柄,产物保存在独立操作目录;用studio_operations核对或取消。
Inputs: url, port, async, outRpPath, +4 more.
studio_get_component_contractsBRead-only
查询自由画布 6 个核心高频组件(button、input-field、list-item、info-card、nav-bar、status-zone)的契约规范(参数、插槽、允许覆盖白名单、锁定内部结构、尺寸规则、状态矩阵、事件语义与调用示例)。
Inputs: url, port, projectDir, componentId.
studio_get_contextBRead-only
读取自由画布当前会话状态(appliedRevision、durableRevision、renderedRevision、contentHash、页面、组件、令牌、字体与恢复摘要)。
Inputs: url, port, verbose, maxBytes, +3 more.
studio_get_design_contextBRead-only
按stage准备规划/骨架/内容/精修/检查/局部改稿上下文。局部改稿先get_context取版本,再传stage:edit、target.pageId/target.revision/nodeIds;返回可编辑源目标和设计决定。target是工程选区,referencePageId是参考页。
Inputs: url, port, brief, stage, +11 more.
studio_merge_documentB
对同一工程执行人类/AI并发编辑或外部 JSON/RP1 文件的三方结构化合并(preview/apply/check-external)。自动合并无关修改,显式报出同字段、删改、跨容器重挂、布局耦合(如 x vs right、父流式 vs 子坐标)、组件实例覆盖与引用冲突,支持逐项裁决并写入单步可撤销事务。
Inputs: url, mode, port, actor, +22 more.
studio_open_projectC
打开或初始化自由画布工程目录(可选从 RP/1 JSON 或 .rp1 源码导入),启动或复用本机单端口 Studio 服务并返回画布上下文。
Inputs: projectDir (required), url, name, port, +2 more.
studio_operationsA
按工程持久查询、列出或取消长操作。可按id或原requestKey核对,MCP断连/服务重开不重做。cancel分别返回请求确认与实际停止;includeResult读取完成结果,过期结果移除提交建议。
Inputs: id, url, port, limit, +4 more.
studio_prepare_mediaB
从原图按焦点/保护主体/比例/底色令牌生成可重放的摄影素材,返回带 SHA 的资源登记命令,不自动改画布。将 registerCommand 和图片节点修改原子提交,支持一起撤销。需要 Python Pillow。
Inputs: crops (required), sourcePath (required), url, port, +5 more.
studio_project_bundleB
导出、校验、导入或对比自包含可迁移工程包(report/export/verify/import/compare)。包含权威文档、组件契约、tokens、变量、数据集、设计决定、版本快照及引用资源/字体闭包(全部相对路径,零宿主机绝对路径泄漏),并生成兼容诊断报告。
Inputs: url, port, action, outDir, +6 more.
studio_project_versionsA
命名保存、列出和预览工程版本;恢复需当前baseRevision、预览返回的previewHash及唯一idempotencyKey,产生可撤销新事务。保存包含设计决定、页面、组件、tokens、数据和资源引用。
Inputs: url, name, port, action, +5 more.
studio_query_nodesBRead-only
按语义/ID/区域查询真实节点,默认8项,返回可编辑源目标、宏/组件控制关系和父布局/padding坐标说明。fields精确取字段、cursor按版本续取;view:full取完整解算节点。跨页重名及过期游标明确拒绝,不扩大目标。
Inputs: url, port, role, type, +11 more.
studio_redoB
重做最近一次已撤销的画布事务并同步浏览器与磁盘。
Inputs: url, port, clientId, projectDir, +1 more.
studio_review_designA
为当前版本创建真实截图和机器检查,返回图片供模型看图;用 reviewId 提交具体 observations。旧版本拒收。compareWithReviewId 可返回前后两张图及变更区域。评审不调用额外模型、不自评审美分、不代表用户验收。
Inputs: pageId (required), baseRevision (required), url, port, +5 more.
studio_run_acceptance_scenariosB
执行12个语义验收模板;有interactionSteps的场景可重放真实浏览器与Axure预览操作。无操作脚本或不支持的断言返回unsupported,不记为通过。
Inputs: url, port, domain, layers, +9 more.
studio_run_scenarioB
在隔离的交互运行态会话(StudioRuntimeSession)中执行业务交互剧本并断言变量、面板状态、文本、显隐与数据集,不污染设计态文档。默认走语义执行层,不做遮挡/hitTest校验:click只要求目标在当前运行态可见,通过≠真实可点。hitTest:true 先用真实浏览器指针重放校验每个点击目标(遮挡/命中按真实DOM结论),被遮挡返回E_SCENARIO_OCCLUDED(含nodeId/occludedBy遮挡者/stepIndex,语义层不执行该步);真实浏览器不可用返回E_SCENARIO_HITTEST_UNAVAILABLE(不静默降级);含navigate/dataset等浏览器层无法重放的步骤返回E_SCENARIO_HITTEST_UNSUPPORTED。步骤示例:{action:"click",target:"reveal",expect:{visible:{answer:true}}};未知步骤或零断言会拒绝。
Inputs: steps (required), url, port, reset, +4 more.
studio_sync_nativeC
将原生 .rp 修改自动收敛回同一 Studio 源文档(preview/apply)。通过基线符号与 GUID 映射到真实作者源 target/propertyMap/父内容盒坐标,覆盖普通节点、宏参数、组件实例覆盖、流式布局排布提示、非激活面板状态、中继器模板(默认保护 =item.xxx 公式不被首行字面量覆盖)与多页三方冲突裁决。
Inputs: rpPath (required), url, mode, port, +13 more.
studio_undoB
撤销最近一次已提交的画布事务并同步浏览器与磁盘。
Inputs: url, port, clientId, projectDir, +2 more.
studio_wait_for_renderBRead-only
等待真实浏览器画布完成指定文档版本(revision)的布局、字体与图片绘制确认。
Inputs: url, port, revision, timeoutMs, +1 more.
sync_prototypeA
源码(RP/1 .rp1/.json 或内联 spec)、MCP 原生改稿与 Axure GUI 改稿三方一致性同步工具。支持 status(检查源码与原生 .rp 是否漂移)、lift(将原生文字/几何/样式/改名/增删元件/交互提取回 RP/1 源码)、merge(基于共同基线做源码与原生改稿三方合并并可输出合并后 .rp 与源码)及 rebuild(带原生改稿防覆盖保护的重建)。默认返回精简变更摘要(summary/lifted*/preserved*)与输出文件路径,避免内联完整源码撑爆上下文;如需在返回 JSON 中内联完整 spec/rp1,可传 includeSpec=true。
Inputs: rp, file, mode, path, +16 more.
verifyARead-only
重新读取磁盘链尾(或通过 path/rp/file 指定的 .rp 文件)并校验(包含 GUI 或外部改动):浅查=三零(unparseable/danglingRefs/problems);deep=true 加同页重复名(跨页共享组件同名汇总在 duplicateSummary,传 includeCrossPageDuplicates=true 可展开全部)、悬空引用与问题明细、全页全容器遍历统计。
Inputs: rp, deep, file, path, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 87 tools
The 87-tool surface contains several near-duplicate paths: rename_widget vs name_widget, edit_text vs set_widget_text vs set_widget_richtext, axure_open vs studio_open_project, verify vs rp_read vs diagnose_prototype, and sync_prototype vs studio_sync_native. Descriptions are detailed, but the overlap across native, RP/1, Studio, and CLI-style workflows makes misselection likely.
All tools use snake_case, avoiding camelCase chaos, but verb order is mixed: create_/set_/add_/remove_/clone_ coexist with noun-first axure_open, jobs_list, rp_read and bare verify/locate/inspect. The large studio_* prefix group is internally consistent, but the overall convention is only partly predictable.
Eighty-seven tools far exceeds a well-scoped surface, even for a complex Axure automation domain. The count is an extreme mismatch with the typical 3-15 range and creates many parallel entry points for similar tasks.
Coverage is broad: creation, editing, interactions, panels, masters, verification, export, sync, image import, design review, and GUI roundtrip are all represented. However direct lifecycle operations for pages, masters, global variables, and custom styles are missing or only indirect, leaving notable gaps despite the huge surface.
Maintenance
Related MCP Connectors
Agent-Native design tool - create and edit visual designs with agent assistance
Your AI agent designs editable, clickable UI prototypes on a live canvas.
Your AI designs live on the UX Pilot canvas or runs its design agent: reviews, React, video, media
Design canvas for agents: create, edit, render and export Figma-shaped designs over MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConnects AI agents to Flato's native editable canvas for design, enabling creation, inspection, revision, export, and visual QA of projects.2MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to create interactive prototypes, annotate UI elements, generate PRDs, and track which annotations and documents need updating after changes.222MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to write AI-generated designs into design-tool canvases (MasterGo, Penpot) as native editable layers, and to read canvas selections back out as HTML + Tailwind, design tokens, and SVG assets. Runs locally with progressive tool disclosure and structurally truncated results so large design files stay within an agent's context budget.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to build and edit a local-first design board of HTML screens, flows, components, design-system pages, and plan tables, then review it in a browser with undo/restore, rendering, and export tools.MIT