Atlas / MCP servers / opaqueglass / Syplugin-an

Syplugin-anCAUTION

Name: Syplugin-an
Author: opaqueglass

mcp/opaqueglass/syplugin-an

MCP server by opaqueglass · siyuan plugin · Audited 2026-10-08

⚑ Report / re-scan Source ↗

A plugin that provide simple MCP service for Siyuan-note

Verdict

CAUTION

Grade

Trust score

89 /100

Exposed tools

43 23r · 13w · 7d

Transport

stdio · streamable-http

License

AGPL-3.0

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

中文

A plugin that provides MCP service for Siyuan Note.

🌻 Features

Most tools support the exclude document function.
It includes certain input parameter validation and is not a direct API wrapper for SiYuan Note.
Ready to use once the plugin is installed and enabled on the desktop client; Docker and mobile platforms are not supported.

✨ Quick Start

Download from the marketplace or 1. unzip the package.zip in Release, 2. move the folder to workspace/data/plugins/, 3. and rename the folder to syplugin-anMCPServer;
Enable the plugin;
The plugin listens on port 16806 by default (Host: 127.0.0.1), please use http://127.0.0.1:16806/sse as the server access address;

⭐ If this is helpful to you, please consider giving it a star!

🛠 Supported Tools (Summary)

For detailed tools, supported excluded documents, and other notes, please refer to the Supported Tools section.

Document and block operations: create, read, update, and delete;
Database operations:
Create databases, add/delete/update database rows, add/delete database columns, and retrieve database structure information;
Attribute operations: create, read, update, and delete;
Flashcard operations: create flashcards from Markdown content, create flashcards by block ID, delete flashcards by block ID;
Template operations: retrieve existing templates, get raw template file content, preview template rendering results, preview Sprig rendering results, create or overwrite templates, render templates and insert at the beginning of a document, delete existing templates;
Notebook operations: list notebooks, rename notebooks;

❓ Frequently Asked Questions

Q1: How to use it in an MCP client?

Please refer to the subsequent sections.

Q2: What are some common MCP clients?
Please refer to: [https://github.com/punkpeye/awesome

Read from source at commit 81df15a393b8OBSERVED · 2026-10-08

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add syplugin-an-mcp-server --env MCP_AUTH_CODE=${MCP_AUTH_CODE} --env SIYUAN_API_KEY=${SIYUAN_API_KEY} --env SIYUAN_API_TOKEN=${SIYUAN_API_TOKEN} -- npx -y [email protected]

claude-desktop

{
  "mcpServers": {
    "syplugin-an-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "MCP_AUTH_CODE": "${MCP_AUTH_CODE}",
        "SIYUAN_API_KEY": "${SIYUAN_API_KEY}",
        "SIYUAN_API_TOKEN": "${SIYUAN_API_TOKEN}"
      }
    }
  }
}

Exposed tools (43)

23 read · 13 write · 7 destructive. Blast radius: 7 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`siyuan_add_database_column`	write	Add a new column to the database.
`siyuan_add_database_row_with_data`	write	Add a new row to the database and get the row ID of the newly added row.
`siyuan_append_block`	read	在指定父块的子块列表最后面插入一个新块,内容为 markdown 格式。
`siyuan_append_markdown_to_doc`	read	Append Markdown content to the end of a document in SiYuan by its ID.
`siyuan_create_database`	write	Create a new database. 返回值包括:avId(数据库ID)和 blockId(数据库所在的块ID),对数据库的操作请求需使用avId。
`siyuan_create_flashcards`	write	Create flashcards from one or more block IDs.
`siyuan_create_flashcards_with_new_doc`	write	Create New Document, and Make Flashcards with Specific Method
`siyuan_create_note_with_md`	write	Create a new note under a parent document in SiYuan with a specified title and Markdown content.
`siyuan_create_template`	destructive	Create a new template file or overwrite an existing one in the SiYuan workspace. This allows users to save reusable content structures for future note creation.
`siyuan_delete_block_by_id`	destructive	根据块ID删除一个块。
`siyuan_delete_database_column`	destructive	Delete a column from the database.
`siyuan_delete_database_rows`	destructive	Delete one or more rows from the database.
`siyuan_delete_doc_by_id`	destructive	Delete a document in SiYuan by its ID.
`siyuan_delete_flashcards`	destructive	Delete flashcards from a deck using their corresponding block IDs.
`siyuan_get_available_rag_service_type`	read	Retrieve the list of currently available RAG (Retrieval-Augmented Generation) services and their IDs in SiYuan Note. Before invoking
`siyuan_get_block_attributes`	read	Get all attributes of a specific block.
`siyuan_get_block_backlinks`	read	Retrieve all documents or blocks that reference a specified document or block within the workspace. The result includes the referencing document
`siyuan_get_database_schema`	read	Get the schema of a specific database.\n\n返回值包括:avId(数据库ID)和 blockId(数据库所在的块ID),对数据库的操作请求使用avId。
`siyuan_get_database_view_schema`	read	Get the schema of a specific view within a database.\n\n返回值包括:avId(数据库ID)和 blockId(数据库所在的块ID),对数据库的操作请求使用avId。
`siyuan_get_raw_template`	read	Retrieve the raw source content of a specified template file. Useful for inspecting or editing the template structure.
`siyuan_insert_block`	write	在指定位置插入一个新块。插入内容必须是 markdown 格式。插入位置可通过
`siyuan_list_database_locations`	read	Finds all content block IDs where a specific database (avId) is instantiated. Use this to locate the physical positions of a database, including its original instance and all mirrored versions.
`siyuan_list_notebook`	read	List all notebooks in SiYuan and return their metadata(such as id, open status, dailyNoteSavePath etc.).
`siyuan_markdown_syntax_help`	read	Provides help with the Markdown syntax used in SiYuan, including supported formatting options and usage examples.
`siyuan_move_block_by_id`	write	移动指定类型的块(如段落、标题、超级块、表格等)到目标位置。注意:此工具不支持移动文档块(Document Block)。
`siyuan_prepend_block`	read	在指定父块的子块列表最前面插入一个新块,内容为 markdown 格式。
`siyuan_preview_rendered_template`	read	Generates the rendered Markdown string of a template without modifying the document. Use this to check the output or get the content for further processing before any insertion.
`siyuan_query_database`	read	Search for rows in the database with keywords.
`siyuan_query_sql`	write	Execute read-only SQL queries to fetch notes and structured data from SiYuan. Mandatory Step: Before writing your SQL, you MUST read the
`siyuan_query_syntax`	read	Provides documentation about SiYuan
`siyuan_read_doc_content`	read	Retrieve the content of a document or block by its ID
`siyuan_remove_template`	destructive	Delete a specified template file from the workspace. This action is permanent.
`siyuan_rename_doc`	write	Rename an existing document in SiYuan by its ID and a new title.
`siyuan_rename_notebook`	write	Rename an existing notebook in SiYuan by its ID and a new title.
`siyuan_render_sprig_template`	read	Render a Sprig template with the specified content.
`siyuan_render_template`	read	Renders a template and INSERTS the result directly into the specified document. Use this when you want to modify the document by prepending template-generated content.
`siyuan_search`	read	Perform a keyword-based full-text search across blocks in SiYuan (e.g., paragraphs, headings). This tool only matches literal text content in document bodies or headings. For dynamic queries (dailynote(i.e. diary), path restrictions, date ranges), use sql with
`siyuan_search_existing_databases`	read	Search for existing databases in the current workspace using keywords. This tool is designed to help you find the avId of an existing database, which is required for other database operations.
`siyuan_search_template`	read	Search for existing templates within the workspace using a keyword. Returns a list of template names that match the search criteria.
`siyuan_sql_helpdoc`	read	Provides documentation about the SiYuan content search database schema relevant to content blocks, including table names, field names, and relationships. This information is essential for constructing effective SQL queries when using the
`siyuan_template_function_help`	read	Provides help with the template functions available in SiYuan, including their syntax and usage examples.
`siyuan_update_block`	write	根据块ID更新现有块的内容,内容应当是 Kramdown 格式。使用markdown格式将丢失块的属性等信息。
`siyuan_update_database_row_with_data`	write	Update an existing row in the database. Columns not explicitly mentioned will remain unchanged unless explicitly updated to blank values. The values of the rollup and template column types cannot be modified using this tool.

Trust audit

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (1 observation(s))
Network: declared (5 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (11)

MEDIUMObfuscation / stealth · obf.zero_width · CWE-506, CWE-94

src/tools/attributeView.ts:212

const domDataBaseStr = `<div contenteditable=\"false\" data-av-id=\"${avId}\" data-av-type=\"table\" data-node-id=\"${blockId}\" data-node-index=\"1\" data-type=\"NodeAttributeView\" class=\"av\" upda

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59

siyuan_create_template, siyuan_delete_block_by_id, siyuan_delete_database_column, siyuan_delete_database_rows, siyuan_delete_doc_by_id, siyuan_delete_flashcards, siyuan_remove_template

Why it matters. 7 tool(s) can delete or overwrite

Fix. prefer a read-only mode or scoped tokens; the page states the blast radius

LOWInventory / provenance · inv.hidden_file · CWE-1104

.eslintignore

.eslintignore

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWInventory / provenance · inv.hidden_file · CWE-1104

.eslintrc.js

.eslintrc.js

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWInventory / provenance · inv.hidden_file · CWE-1104

scripts/.release.py

.release.py

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose