moki-whiteboard
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MOKI_WHITEBOARD_DATA | Yes | Absolute path to the MOKI Whiteboard SQLite database file, e.g. D:/path/to/moki-whiteboard/data/moki-whiteboard.db | |
| MOKI_WHITEBOARD_MCP_TOKEN | No | Optional token for local authentication when using Streamable HTTP MCP. Not intended for public exposure. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whiteboard_renameA | Rename an explicit board. Supply expectedVersion from inspect for conflict protection. 重命名明确指定的白板;支持版本校验。 |
| whiteboard_duplicateC | Duplicate all pages and content of a board, preserving image and file references. 复制白板的全部页面与内容;图片和文件引用保留。 |
| whiteboard_delete_boardA | Permanently delete an explicit board; requires confirm=true. Prefer expectedVersion. Does not delete original mapped files. 删除明确指定的整张白板,不可撤回;需要 confirm=true,建议提供 expectedVersion。不会删除原始映射文件。 |
| whiteboard_get_thumbnailA | Read the last saved board screenshot and its version. A thumbnail may be unavailable until the board has been opened and saved in the UI. 读取最后一次编辑保存的真实白板截图。尚未打开编辑的白板可能没有截图;返回截图版本和是否最新。 |
| whiteboard_listA | List local whiteboards. Start here to choose an explicit boardId before inspecting or editing. 列出可供 Agent 操作的所有白板文档。 |
| whiteboard_createB | Create a local whiteboard with one empty page. Returns the new board ID and version. 创建一个独立白板文档,并自动包含一个空白页面。 |
| whiteboard_inspectA | Inspect pages, element IDs, text, bounds, styles, version, and agent context. Read before and after editing. The default board is the most recently updated, not necessarily the board open in the UI. 读取页面、元素 ID、位置、尺寸、颜色和文本。修改前先调用此工具取得准确 ID。 |
| whiteboard_create_pageB | Create a page in an explicit board and make it the current page. 在指定白板中创建新页面,并将其设为当前页面。 |
| whiteboard_manage_pagesB | List, rename, reorder, group, or delete pages. Deleting a page also deletes its content; at least one page must remain. 列出、重命名、移动到分组或删除页面。删除页面也会删除该页内容,且白板至少保留一页。 |
| whiteboard_manage_page_groupsB | List, create, rename, or delete page groups. Deleting a group preserves its pages as ungrouped. 创建、重命名、删除或列出页面分组;删除分组时页面会保留并回到未分组。 |
| whiteboard_add_elementsB | Add sticky notes, text, shapes, arrows, drawings, mind maps, images, files, or links in batches. Positions use canvas world coordinates; omitted positions are arranged automatically. 批量添加便签、文本、图形、箭头、画笔、思维导图、图片、文件或链接。坐标是无限画布世界坐标;省略坐标时自动排列。 |
| whiteboard_update_elementsB | Update text, position, size, color, or rotation by exact element IDs. 按准确元素 ID 批量修改文本、位置、尺寸、颜色或旋转角度。 |
| whiteboard_align_elementsA | Align or evenly distribute two or more elements using their exact IDs. 将两个或更多元素按边缘、中心或间距进行对齐分布。 |
| whiteboard_delete_elementsA | Delete only the explicitly listed element IDs, not pages or entire boards. 仅删除明确给出的元素 ID。不会删除页面或整个白板。 |
| whiteboard_exportA | Export a snapshot and .moki download URL (requires the HTTP API). With includeArchive=true, return a self-contained Base64 ZIP with images/files, up to 8 MiB; use app or HTTP export for larger boards. 返回完整快照和 .moki ZIP 下载地址(下载需要 API)。includeArchive=true 时直接返回含图片/文件的归档 Base64,无需 API;归档最多 8 MiB,较大白板请通过应用导出。 |
| whiteboard_native_editB | Use the native canvas editor for properties, grouping, collapsing groups into virtual folders, expanding folders, and mind-map branches. Inspect/export exact IDs and records first. Rotation is in degrees. 直接调用与 UI 相同的 MOKI 原生编辑器。支持原生 props 编辑、分组/资料夹,以及真正的思维导图分支操作。先 whiteboard_inspect/whiteboard_export 获取准确 ID 和记录;rotation 使用角度。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| operate-moki-whiteboard | 引导 Agent 安全、可验证地编辑白板 |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| 当前 MOKI 白板 | 最近更新白板的页面与元素结构;不等同于当前浏览器打开的白板 |
| 我的白板 | 指定白板的完整原生快照 |
TDQS
Scored across 16 tools
Most tools target distinct board, page, or element operations, but whiteboard_native_edit is very broad and overlaps with whiteboard_update_elements, whiteboard_add_elements, and whiteboard_manage_page_groups. The boundary between whiteboard_manage_pages (which can group pages) and whiteboard_manage_page_groups is also somewhat unclear. Descriptions help, but an agent may still hesitate between native editing and targeted element/page tools.
Every tool uses the whiteboard_ prefix and snake_case, with a predictable verb_noun or resource_action pattern. Variations like whiteboard_delete_board vs. whiteboard_delete_elements are still readable and consistent within the board-level naming domain.
At 16 tools, the surface is slightly above the ideal 3-15 range but remains reasonable for a whiteboard server covering boards, pages, groups, elements, thumbnails, and export. Each tool appears to earn its place, though some consolidation could reduce overlap.
The set covers board CRUD, page management, page groups, element creation/update/alignment/deletion, inspection, thumbnail retrieval, native editing, and export. Minor gaps remain, such as explicit page duplication or dedicated element grouping, but core lifecycle workflows are well covered.