메뉴
MCP playbook for browsing and reading SiYuan notes. Use for notebooks, document trees, human-readable paths, IDs, storage paths, block content, and read-only discovery.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
MCP playbook for creating and editing SiYuan documents and blocks. Use for path-based document creation, block append/insert/update, metadata, daily notes, and verified edits.
MCP playbook for SiYuan attribute views. Use to inspect database metadata, render views, add columns or rows, update cells, and keep AV, view, row, column, and block IDs distinct.
MCP playbook for SiYuan assets and exports. Use for uploads, Markdown export, document extraction, resource ZIP export, OCR text, templates, and safe asset maintenance.
MCP SiYuan markup guide for rich Markdown written through block and document actions. Use for headings, lists, tasks, tables, code, math, diagrams, tags, callouts, super blocks, embeds, and block references.
MCP playbook for finding and querying SiYuan content. Use for fulltext, read-only SQL, backlinks, references, assets, dynamic query blocks, and safe find-replace.
Top-level skill for operating SiYuan Note through the Sisyphus MCP server. Use to choose an aggregated tool, discover action resources, route complex tasks to a scenario skill, and apply permissions and safety rules.
| name | siyuan-mcp-browse-read |
| description | MCP playbook for browsing and reading SiYuan notes. Use for notebooks, document trees, human-readable paths, IDs, storage paths, block content, and read-only discovery. |
Start with fs and human-readable paths. Drop to document or block actions only when IDs, storage paths, metadata, or block structure are required.
notebook(action="list")
fs(action="ls", path="/")
fs(action="tree", path="/Notebook/Folder", maxDepth=4)
fs(action="read", path="/Notebook/Folder/Doc", page=1, pageSize=8000)
Use search-assisted discovery when the path is unknown:
fs(action="search", path="/Notebook", query="keyword", page=1, pageSize=20)
search(action="fulltext", query="keyword", page=1, pageSize=20)
document(action="lookup", id="<doc-id>", include=["path","hpath","notebook"])
document(action="get_doc", id="<doc-id>", mode="markdown")
block(action="get_kramdown", id="<block-id>")
| Value | Example | Typical use |
|---|---|---|
| Workspace path | /Notebook/Folder/Doc | fs actions |
| Notebook-local hpath | /Folder/Doc | document create or lookup with notebook |
| Storage path | /20260712123000-abc123.sy | low-level rename, remove, or move |
Never derive a storage path from a title. Resolve the document first and reuse the returned path. Treat pages and truncation notices as incomplete data, and continue with explicit page and pageSize values.