← ClaudeAtlas

siyuan-mcp-sisyphuslisted

Operate SiYuan notes via 8 aggregated MCP tools (notebook/document/block/file/search/tag/system/mascot). Covers path semantics, permissions, block editing, search, tags, export, and mascot actions.
yangtaihong59/siyuan-plugins-mcp-sisyphus · ★ 70 · Data & Documents · score 77
Install: claude install-skill yangtaihong59/siyuan-plugins-mcp-sisyphus
# SiYuan MCP Sisyphus 8 aggregated MCP tools for SiYuan note operations. Each tool takes an `action` parameter. Full parameter schemas are in the tool descriptions; use `action="help"` on any tool for detailed guidance. ## Recommended Workflow 1. **Explore**: `notebook(action="list")`, `system(action="get_version")` 2. **Locate**: `document(action="get_path" | "get_hpath" | "get_ids")` 3. **Write**: `document(action="create" | "rename" | "move")`, `block(action="append" | "update" | ...)` 4. **Verify**: `document(action="get_child_blocks")` or `block(action="get_children")` ## Getting Help - Call any tool with `action="help"` to get its actions, required fields, hints, and examples. - MCP resources are also available if your client supports them: - `siyuan://help/tool-overview` — all tools, enabled actions, and guidance - `siyuan://help/document-path-semantics` — path type details with examples - `siyuan://help/examples` — minimal call examples for common actions - `siyuan://help/ai-layout-guide` — layout and block-type decision rules - `siyuan://help/action/{tool}/{action}` — per-action parameter shapes ## Disabled-by-Default Actions These actions return `{error: {type: "action_disabled"}}` unless enabled in SiYuan plugin settings. | Tool | Action | |------|--------| | notebook | `remove` | | notebook | `set_permission` | | document | `remove` | | block | `delete` | ## Permission System Four levels per notebook: `rwd` (read/write/delete), `rw` (read/write