Board WebMCP
Use this skill to operate the native board demo through @webmcp-bridge/local-mcp.
Prerequisites
- -
uxc is installed and available in PATH. - INLINECODE3 is installed and available in
PATH. - Network access to
https://board.holon.run. - On a fresh machine, or under an isolated
HOME, install Playwright browsers first with npx playwright install. - For local board development, point the setup script at
http://127.0.0.1:4173.
Core Workflow
- 1. Ensure the fixed board link exists:
-
command -v board-webmcp-cli
- if missing or pointed at the wrong URL, run
skills/board-webmcp/scripts/ensure-links.sh
- 2. Inspect the bridge and tool schema before calling tools:
-
board-webmcp-cli -h
-
board-webmcp-cli nodes.list -h
-
board-webmcp-cli nodes.upsert -h
- 3. Read current board state:
- non-collaborative automation:
board-webmcp-cli nodes.list,
board-webmcp-cli edges.list
- collaborative visible session:
-
board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}'
-
board-webmcp-cli bridge.open
-
board-webmcp-cli nodes.list
-
board-webmcp-cli edges.list
- 4. Apply updates with structured inputs:
-
board-webmcp-cli diagram.export format=json
- collaborative visible session should keep the same runtime in
headed
-
board-webmcp-cli nodes.upsert '{"nodes":[{"label":"Fraud Service","kind":"service"}]}'
-
board-webmcp-cli edges.upsert '{"edges":[{"sourceNodeId":"gateway","targetNodeId":"orders","protocol":"grpc"}]}'
-
board-webmcp-cli layout.apply mode=layered
-
board-webmcp-cli diagram.export format=json
- 5. When a human is editing or reviewing the same board live:
- check current state with
board-webmcp-cli bridge.session.status
- if needed, switch to headed with
board-webmcp-cli bridge.session.mode.set '{"mode":"headed"}'
-
board-webmcp-cli bridge.open
- keep all reads and writes on
board-webmcp-cli for that same collaborative session
-
board-webmcp-cli selection.get
-
board-webmcp-cli bridge.close
- if the human closed the board window manually, the headed owner session has ended; run
board-webmcp-cli bridge.open again to start a new headed session on the same profile
Default Target
The default public target is:
CODEBLOCK0
The default board profile path is:
CODEBLOCK1
Use the helper script to refresh the link for the public deployment:
CODEBLOCK2
Use the helper script to point the link at local development instead:
CODEBLOCK3
If the bridge fails to start on a fresh machine or inside an isolated HOME, install Playwright browsers in that environment first:
CODEBLOCK4
Guardrails
- -
board.holon.run is a shared demo. Writes are visible on the board surface and persisted in browser storage for that profile. - Prefer explicit
bridge.session.mode.set over relying on a new launcher invocation to change runtime mode. - Before collaborative editing, confirm the runtime is actually
headed. - If the human closes that window manually, the headed owner session ends. The next
board-webmcp-cli bridge.open starts a new headed session on the same profile. - Keep the board profile isolated from other sites.
- Use JSON output for automation. Do not depend on human-formatted text output.
References
- - Common command patterns:
-
references/usage-patterns.md
- INLINECODE39
Board WebMCP
使用此技能通过 @webmcp-bridge/local-mcp 操作原生面板演示。
前提条件
- - uxc 已安装并可在 PATH 中使用。
- npx 已安装并可在 PATH 中使用。
- 可访问 https://board.holon.run 的网络。
- 在新机器或隔离的 HOME 环境下,先使用 npx playwright install 安装 Playwright 浏览器。
- 对于本地面板开发,将设置脚本指向 http://127.0.0.1:4173。
核心工作流程
- 1. 确保固定面板链接存在:
- command -v board-webmcp-cli
- 如果缺失或指向错误的 URL,运行 skills/board-webmcp/scripts/ensure-links.sh
- 2. 在调用工具前检查桥接和工具模式:
- board-webmcp-cli -h
- board-webmcp-cli nodes.list -h
- board-webmcp-cli nodes.upsert -h
- 3. 读取当前面板状态:
- 非协作自动化:board-webmcp-cli nodes.list、board-webmcp-cli edges.list
- 协作可见会话:
- board-webmcp-cli bridge.session.mode.set {mode:headed}
- board-webmcp-cli bridge.open
- board-webmcp-cli nodes.list
- board-webmcp-cli edges.list
- 4. 使用结构化输入应用更新:
- board-webmcp-cli diagram.export format=json
- 协作可见会话应保持相同的 headed 运行时
- board-webmcp-cli nodes.upsert {nodes:[{label:Fraud Service,kind:service}]}
- board-webmcp-cli edges.upsert {edges:[{sourceNodeId:gateway,targetNodeId:orders,protocol:grpc}]}
- board-webmcp-cli layout.apply mode=layered
- board-webmcp-cli diagram.export format=json
- 5. 当有人实时编辑或审查同一面板时:
- 使用 board-webmcp-cli bridge.session.status 检查当前状态
- 如有需要,使用 board-webmcp-cli bridge.session.mode.set {mode:headed} 切换到 headed 模式
- board-webmcp-cli bridge.open
- 在同一协作会话中,所有读写操作均通过 board-webmcp-cli 进行
- board-webmcp-cli selection.get
- board-webmcp-cli bridge.close
- 如果用户手动关闭了面板窗口,headed 所有者会话已结束;运行 board-webmcp-cli bridge.open 在同一配置上启动新的 headed 会话
默认目标
默认公共目标为:
bash
https://board.holon.run
默认面板配置路径为:
bash
~/.uxc/webmcp-profile/board
使用辅助脚本刷新公共部署的链接:
bash
skills/board-webmcp/scripts/ensure-links.sh
使用辅助脚本将链接指向本地开发环境:
bash
skills/board-webmcp/scripts/ensure-links.sh --url http://127.0.0.1:4173
如果桥接在新机器或隔离的 HOME 环境中启动失败,请先在该环境中安装 Playwright 浏览器:
bash
npx playwright install
防护措施
- - board.holon.run 是一个共享演示。写入内容在面板表面可见,并持久化存储在该配置的浏览器存储中。
- 优先使用显式的 bridge.session.mode.set,而不是依赖新的启动器调用来更改运行时模式。
- 在协作编辑前,确认运行时确实处于 headed 模式。
- 如果用户手动关闭了窗口,headed 所有者会话结束。下一次 board-webmcp-cli bridge.open 将在同一配置上启动新的 headed 会话。
- 保持面板配置与其他站点隔离。
- 使用 JSON 输出进行自动化。不要依赖人类可读的文本输出。
参考
- references/usage-patterns.md
- scripts/ensure-links.sh