核心功能

MCP 工具列表

Ardot MCP Server 提供以下 18 个工具（更多 API 持续更新中）：

查询类

工具名	说明
fetch_editor_state	获取当前编辑器状态，包括活跃画布、用户选区、打开的文件等基本信息，适合在开始设计任务前了解当前上下文
fetch_file_info	获取当前活跃设计文件的基本信息，包括文件名、文件链接、文件 ID 以及当前用户的访问权限，可在执行编辑操作前确认是否具备写入权限
batch_read	批量检索节点——支持按 name/type 正则模式搜索、按节点 ID 精确查找，可控制返回层级深度和数据详细程度，并支持按需返回指定属性
capture_screenshot	获取指定节点或画布区域的截图，用于验证 AI 生成的布局是否正确、检查视觉效果和组件外观，支持批量截图（建议单次不超过 10 个）
capture_layout	获取设计文件的布局结构树，支持按深度限制返回范围，可仅返回存在重叠、裁剪等布局问题的节点

设计系统

工具名	说明
fetch_variables	读取设计文件中定义的变量（Design Token），包括颜色、间距、字号等，可用于生成 CSS 全局样式规则
apply_variables	创建或更新设计变量集合，支持多模式（如 Light/Dark），支持 COLOR、FLOAT、BOOLEAN、STRING 四种变量类型，默认合并模式
fetch_component_lib	获取本地组件库中的组件与组件集合，便于在通过 batch_edit 创建实例前先发现可复用组件
fetch_guidelines	获取不同主题设计规范指引，支持 7 个主题：table（表格）、landing-page（落地页）、web-app（Web 应用）、mobile-app（移动端）、slides（幻灯片）、code（代码生成）、tailwind（Tailwind CSS v4）
search_style_guide	跨多个设计领域（风格、配色、字体、布局）搜索风格指南候选项，为落地页、营销站、看板或应用界面等设计任务提供创意方向与视觉灵感
build_style_guide	基于 search_style_guide 的选择结果构建完整设计系统，输出包含颜色、字体、间距、效果等参数的 Markdown 设计规范

编辑操作

工具名	说明
batch_edit	批量执行设计操作，支持 6 种操作类型：Insert（插入）、Copy（复制）、Update（更新）、Move（移动）、Delete（删除）、Image（生成/获取图片），每次调用建议不超过 25 个操作
locate_available_space	在画布中按指定方向（上/右/下/左）和尺寸查找空白区域，可指定起始参考节点和最小间距，用于放置新设计内容
create_new_page	在当前 .ardot 文件中新增一个空白页面（CANVAS），可指定页面名称、插入位置以及是否切换焦点至新页面

资源与导出

工具名	说明
scan_exportable_resources	扫描节点树并按类型返回可导出的资源节点（image、svg），用于在调用 export_nodes 前确定导出范围与格式
export_nodes	将节点导出为 PNG、JPEG、WEBP、SVG、PDF 等格式的图像文件，PDF 模式可将多个 Frame 合并为单个文件
upload_images	批量上传本地图片文件并将其作为图像填充应用到指定节点，支持 PNG、JPEG、WEBP，单次最多 20 项

辅助工具

工具名	说明
get_available_fonts	获取当前环境中可用的字体列表及其样式，用于在创建文本节点后验证字体是否可用，确保使用正确的 fontName（family + style）组合