MCP server 与 agent skill
MCP。 server 在本地通过 stdio 运行,提供 workflow、tree、find、search、usages、diff、inspect、nodes、variables、bundle、verify、index、jobs、changes、watch、export、export_batch、compare_image 和 models。export_batch 一次调用最多写出 64 个文件,返回 manifest 而非内嵌图片。请传入绝对路径。加上 --root /path/to/designs(可重复)可把所有文件和输出路径限制在指定文件夹内。明确指定自定义索引位置时,需要 --storage-root DIR(可重复);已记住的 workspace 位置无需再次指定。参见启动参数及多个 root 的配置示例。光栅导出会缩小到 maxSize(默认 1600 px),让内联图片保持小巧;SVG 只返回 metadata。
agent 可通过 workflow 读取内建的 build、audit、images、search、plan、planning-details,或明确请求时的 yolo 指引。它们与 portable skill 共用来源;MCP 用户可自行选择是否另装 skill。实际工作仍由 agent 使用项目及浏览器工具,并遵守 host 权限。读取指引不会执行工作流程;使用方式取决于客户端支持与模型行为。
在原生 Windows 上使用 Claude Code:请参照其 stdio 设置说明,并为 npx 加上 cmd /c 包装。
Skill。 figlens skill 教 agent 查找 frame、分段阅读 bundle、规划限定范围的工作,并对照设计验证运行中的 UI。它只安装说明;CLI 或 MCP server 必须另行可用。可用 Skills CLI 安装,或把 skills/figlens/ 复制到 agent 的 skills 目录(Claude Code:~/.claude/skills/):
npm install -g @runkids/figlens
npx skills add runkids/figlens --skill figlens
Plugin。 Claude Code、Codex、Antigravity、Cursor 和 Kimi Code 可以把 skill 和 MCP server 作为一个 plugin 一起安装;见 Plugin 设置。
skillshare。 用 skillshare 在一处统一管理 Claude Code、Codex 和 Cursor 的 skill 与 MCP 连接:
skillshare install github.com/runkids/figlens/skills/figlens
skillshare mcp add figlens --global --target claude --target codex --target cursor --no-tui -- npx -y @runkids/figlens mcp
skillshare sync && skillshare sync mcp --global
安装说明。 npm launcher 会在首次使用时下载匹配的原生可执行文件,对照 release 的 SHA-256 校验和进行验证并缓存。用安装脚本装的通过 figlens update 更新;Homebrew 装的通过 brew upgrade figlens 更新。可执行文件覆盖 macOS(Apple silicon、Intel)、Linux(arm64、x86_64、静态 musl)和 Windows(x86_64)。每种安装方式都会把可选的语义搜索所用的运行时 figlens-embed 放在 figlens 旁边;在你配置模型之前,它不会加载任何模型。
本页内容取自仓库中的 docs/README-zh-CN.md。