Siyuan MCP Server

by xgq18237• 73•• Scanned•Claim this listing•Request removal
Other

思源笔记MCP / SiYuan MCP Server

Siyuan MCP Server is an open-source mcp server by xgq18237, written mainly in TypeScript, with 73 GitHub stars and the MIT license. Its code was last updated Jun 29, 2026. The latest npm release is siyuan-mcp 1.1.1, published Jun 28, 2026, with 94 downloads last week.

Scan summary: scanned Nov 5, 2026 at commit bc82945. Seen able to read or write files, connect to databases, touch money or trading. Scan policy

aboutREADMEsecurityreviews

How to install Siyuan MCP Server

Built from the start command in the project's README: npx -y siyuan-mcp@latest. Check the README for required keys or settings.

Claude Code · Terminal
claude mcp add siyuan-mcp-server -- npx -y siyuan-mcp@latest
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "siyuan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "siyuan-mcp@latest"
      ]
    }
  }
}
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "siyuan-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "siyuan-mcp@latest"
      ]
    }
  }
}
VS Code · Terminal
code --add-mcp '{"name":"siyuan-mcp-server","command":"npx","args":["-y","siyuan-mcp@latest"]}'

What Siyuan MCP Server can touch

  • Run shell commandsNot seen in this scan
  • Run dynamic codeNot seen in this scan
  • Read or write filesListed as a tool: read_dir
  • Read environment and secretsNot seen in this scan
  • Control a web browserNot seen in this scan
  • Connect to databasesListed as a tool: sql_query
  • Read or send messagesNot seen in this scan
  • Touch money or tradingListed as a tool: transfer_block_ref
  • Connect to the internetNo connections seen while running

"Not seen" means our checks did not find it, and the tool may still do it. Covers commit bc82945, Nov 5, 2026. See the scan policy.

Before you install Siyuan MCP Server

AgenticMart scanned Siyuan MCP Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What it can access

  • An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.

Before you install

  1. Pin the version you reviewed instead of always installing the latest release.
  2. Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
  • Maintained by xgq18237 on GitHub, 73 stars and 15 forks. Popularity is not proof of safety.
  • Last code change: Jun 29, 2026.
  • Open-source license: MIT.
Read the scan reportWhat our scan checks

Tools Siyuan MCP Server exposes (69)

Listed by the server itself during our scan of commit bc82945.

  • list_notebooks

    列出所有思源笔记本及其打开状态

  • open_notebook

    打开指定笔记本

  • close_notebook

    关闭指定笔记本

  • rename_notebook

    重命名笔记本

  • create_notebook

    创建新笔记本

  • remove_notebook

    删除笔记本及其内容；可通过保护开关禁用

  • get_notebook_conf

    获取笔记本配置

  • set_notebook_conf

    保存笔记本配置

  • create_doc

    在指定笔记本中新建 Markdown 文档

  • rename_doc

    按存储路径重命名文档

  • rename_doc_by_id

    按 ID 重命名文档

  • remove_doc

    按路径删除文档

  • remove_doc_by_id

    按 ID 删除文档

  • move_docs

    移动一组文档

  • move_docs_by_id

    按 ID 移动一组文档

  • search_docs

    按标题搜索文档

  • list_docs

    列出指定笔记本路径下的文档

  • get_hpath_by_path

    根据存储路径获取人类可读路径

  • get_hpath_by_id

    根据 ID 获取人类可读路径

  • get_path_by_id

    根据 ID 获取存储路径

  • get_ids_by_hpath

    根据人类可读路径获取 ID

  • insert_block

    在指定锚点插入块；nextID、previousID、parentID 至少提供一个

  • prepend_block

    在父块开头插入子块

  • append_block

    在父块末尾插入子块

  • update_block

    更新块内容

  • delete_block

    删除块

  • move_block

    移动块；previousID 或 parentID 至少提供一个

  • batch_insert_blocks

    批量插入块

  • batch_update_blocks

    批量更新块

  • get_block_info

    获取块的元数据

  • get_block_breadcrumb

    获取块的面包屑路径

  • get_block_kramdown

    获取块 Kramdown 源码

  • get_child_blocks

    获取直接子块

  • fold_block

    折叠块

  • unfold_block

    展开块

  • transfer_block_ref

    转移块引用

  • set_block_attrs

    设置块属性

  • get_block_attrs

    获取块属性

  • search_blocks

    使用思源全文搜索查找内容块

  • sql_query

    执行 SQL 语句；调用方应自行确认写入类语句的影响

Siyuan MCP Server is an open-source mcp server by xgq18237, written mainly in TypeScript. 思源笔记MCP / SiYuan MCP Server

At a glance

Stars
73
Forks
15
Language
TypeScript
License
MIT
Created
Aug 2025
Last update
Jun 29, 2026
Type
MCP Server
Price
Free

Questions about Siyuan MCP Server

What is Siyuan MCP Server?

思源笔记MCP / SiYuan MCP Server

Who maintains Siyuan MCP Server?

Siyuan MCP Server is maintained by xgq18237 on GitHub (xgq18237/siyuan_mcp_server). AgenticMart lists it from public repository data.

Is Siyuan MCP Server safe to use?

AgenticMart scanned Siyuan MCP Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What license does Siyuan MCP Server use?

It is published under the MIT license.

Siyuan MCP Server alternatives

View more →

Similar mcp servers in Other, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

NameStarsLicenceLast updatedScan
Siyuan MCP Server (this page)
xgq18237
73MITJun 29, 2026Scanned, no flagged issues
Github MCP Server
github
34kMITOct 30, 2026Scanned, no flagged issues
Fastapi MCP
tadata-org
12kMITNov 24, 2025Scanned, no flagged issues
GhidraMCP
LaurieWired
12kApache-2.0Oct 10, 2026Scanned, no flagged issues
MCP Go
mark3labs
9.2kMITOct 30, 2026Scanned, no flagged issues
Git MCP
idosal
8.5kApache-2.0May 8, 2026Scanned, no flagged issues