Skip to main content
Glama
fyuanace

fsiyuanmcp

by fyuanace
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

思源 HTTP MCP 服务

仅桌面端：支持 Windows / macOS / Linux 思源桌面客户端；不支持手机、平板等移动端（Android / iOS / Harmony）。MCP 需在本机拉起 Node 服务，供 Cursor 等客户端连接。

扁平长标题笔记 + 标签/双链图谱。写操作限制在一个可写笔记本。

核心能力

  • 写入 save_note(title, markdown, summary?, tags?, refs?)：同名更新保留 id；标准 Markdown；[[标题]] 自动转思源双链（仅可写笔记本）

  • 检索 search_notes：全库只读；两轮（文档名→标题块）；命中 ≤5 篇附全文；含图谱邻居

  • 浏览 list_docs：列出笔记本顶层文档，或某文档的直接/递归子文档（任意笔记本只读）

  • 读取 read_note：任意笔记本只读；正文末尾自动附附件本地路径（assets[] 同步列出）

  • 删除 delete_content / delete_docs：按关键字或 id 批量删除（仅可写笔记本）

  • 版本 get_plugin_version

Related MCP server: SiYuan MCP Server

推荐流程

  1. list_docs({ notebookId? }) 或 list_docs({ parentId }) 浏览文档树

  2. search_notes({ query }) → 若 includeFullText 则已有正文；否则按 summary/tags/refs 筛选

  3. read_note({ id }) 读 2～4 篇

  4. save_note({ title, markdown, summary, tags, refs }) 新建或更新（仅可写笔记本）

  5. 删除：delete_docs({ ids, confirm:true }) 或 delete_content({ query, scope:"document", confirm:true })

文档约定

  • 无分类文件夹；标题建议 15～40 字概括主题

  • 顶部元数据：YAML frontmatter（主要内容 / 更新日期 / 标签 / 引用文档），不写思源文档属性

  • 文档过大时结果带 tooLarge，新内容另建并用 [[旧标题]] 互链

Resources

  • siyuan://tags

  • siyuan://notebooks

启动

npm install
npm run build
npm run dev

默认 MCP：http://127.0.0.1:3900/mcp。改工具后需重启服务并在 Cursor 重连。

思源插件设置页可用「读取后端版本」对照 plugin.json 与正在监听的进程；不一致时先点「保存并重启」。

测试

npm test

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • SiYuan Note MCP Server

    onigeya
    -
    license
    C
    quality
    Not graded
    maintenance
    An MCP server implementation that integrates with SiYuan Note system, enabling AI models to access and manipulate note data through comprehensive commands for notebook management, document operations, and content manipulation.
    3
    4 npm
    41
    -

  • SiYuan MCP Server

    GALIAIS
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    An MCP server for SiYuan Note that enables comprehensive management of notebooks, documents, and blocks through AI integration. It supports advanced operations like SQL querying, OCR, multi-format exports, and automated content searching for intelligent knowledge management.
    10 npm
    5
    -

  • siyuan-ai-mcp-bridge

    appdev
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides a local MCP stdio server that enables AI clients to read, search, create, update, and delete notes in SiYuan through its Kernel HTTP API, with configurable notebook and tool permissions.
    MIT

  • siyuan-mcp-server

    leolulu
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with the SiYuan note-taking knowledge base through standardized MCP tools, supporting notebook/document/block operations with built-in sensitive data masking and notifications.
    10
    MIT