用途:调用 Pencil MCP 工具 get_variables,从 Pencil 的 .pen 文件中读取设计令牌变量,包括颜色、字体(排版)和间距,便于在设计任务中使用语义化名称而非硬编码色值。
主要能力:获取当前文档中定义的全部变量;可指定 filePath 从其他 .pen 文件(如共享库)读取变量;输出为变量定义的列表或映射,可用于检查当前主题、审计主题,并在 batch_design 操作中通过变量 ID 或名称引用,例如 fill: { type: "var", id: "var_123" }。
使用方式:调用 get_variables()。可选参数 filePath(字符串,可选)为 .pen 文件路径。若客户端对 MCP 工具做命名空间处理,工具可能显示为 mcp__pencil__get_variables。
适用场景:需要了解 Pencil 中可用的设计令牌;希望使用 primary-color 等语义名称;检查当前主题;读取共享库中的令牌。触发说法包括“获取 Pencil 变量”“读取 Pencil 设计令牌”“检查 Pencil 颜色”“列出 Pencil 主题值”。
限制:必须先确认用户意图,仅在用户明确提到 Pencil 或当前对话明确属于 Pencil 设计任务时使用;否则不要使用,例如“获取变量”可能指环境变量或代码变量。资料未提供其他限制、收费或平台信息。