🚀 让思源笔记开挂起飞：SiYuan Sisyphus MCP & CLI 完全指南

一句话总结： 这个插件让 Claude、Cursor 等 AI 助手直接读写你的思源笔记，12 个工具覆盖 100+ 操作，从此你的第二大脑真正有了"智能灵魂"。

---

一、笔记：我的第二大脑

我是一个不折不扣的笔记控。

工作复盘、项目记录、生活灵感、读书批注……方方面面都要记下来。对我来说，笔记不是可有可无的附属品，而是我不可或缺的第二大脑。

这些年试过不少工具后，我最终选择了思源笔记，理由很简单：

✅ 数据完全本地化 —— 笔记存在你自己的硬盘上，不依赖任何云端服务

✅ 块级编辑 + 双链 —— 每个段落、每张图片都是一个"块"，可以自由组合引用

✅ Docker 部署 —— 搭在 NAS 上，局域网和外网都能访问，完美！

我以为这就是终点了。直到我发现思源的 AI 功能……

---

二、思源的 AI 之痛：能力太弱，鸡肋中的鸡肋

思源自带的 AI 功能，怎么说呢？

用一句话概括：能用，但不好用，更不够用。

你让它搜索笔记，它只能做简单的关键词匹配；你让它帮你整理笔记，它连你的笔记本列表都看不到；你想让 AI 根据你过去三个月的读书笔记写一篇总结？对不起，做不到。

问题出在哪？

AI 和你的笔记之间，缺一座桥。

思源的笔记数据存储在它自己的数据库里，对外暴露的接口（API）虽然有，但 AI 工具（比如 Claude、ChatGPT）根本不知道怎么调用。就好比你有一座藏书万卷的图书馆，但门口没有管理员，也没有目录索引——AI 站在门外干瞪眼。

直到我发现了 SiYuan Sisyphus MCP & CLI 这个插件。

一切都变了。

---

三、什么是 MCP？先搞懂这个"AI 的 USB-C 口"

在讲插件之前，先花 1 分钟搞懂一个关键概念：MCP（Model Context Protocol，模型上下文协议）。

这是 Anthropic（Claude 的母公司）推出的一个开放标准协议，你可以把它理解为：

MCP 就是 AI 世界的 USB-C 接口。

以前，每个 AI 工具想连接外部数据源，都要写一套专用代码——接数据库要写一套，接笔记软件要写一套，接文件系统又要写一套。

MCP 的出现统一了这个局面：只要你的数据源实现了 MCP 协议，任何支持 MCP 的 AI 工具都能直接对接。

现在支持 MCP 的 AI 工具已经很多了：Claude Desktop、Claude Code、Cursor、Cherry Studio、Cline……而 SiYuan Sisyphus，就是思源笔记的 MCP Server 实现。

翻译成人话就是：装了这个插件，你的 AI 助手就能直接读写思源笔记了。

---

四、SiYuan Sisyphus：让思源瞬间开挂的神器

📌 项目信息

项目	详情
名称	SiYuan Sisyphus MCP & CLI
仓库	GitHub - yangtaihong59/siyuan-plugins-mcp-sisyphus
文档	官方文档站
npm	siyuan-sisyphus
当前版本	v0.4.9（2026-05-24 更新）
许可证	MIT（完全开源免费）

📌 它是什么？

一句话：一个让 AI 能读懂、能改写、能管理你整个思源笔记库的"超级翻译官"。

它有两种使用方式：

• 插件模式：在思源笔记的插件市场直接安装，图形化配置
• CLI 模式：通过命令行操作，适合自动化脚本和极客玩家
  
  

两种模式共享同一套权限系统和底层操作，安全且一致。

---

五、12 个工具，100+ 操作：它到底能干啥？

这是这个插件最让人兴奋的部分——它把思源笔记的几乎所有能力都开放给了 AI。

总共 12 个工具组，每个工具组下面有多个具体的"动作"（action），加起来超过 100 种操作。

📖 阅读与检索：让 AI 帮你"翻遍"笔记库

场景	你说的话	AI 做的事
搜索笔记	"帮我找所有包含'AI'的笔记"	全文检索，返回匹配结果
深度挖掘	"找到我写过的关于读书的日记"	结合关键词 + 时间范围精准定位
知识关联	"哪些笔记引用了这篇文档？"	反向链接查询，发现隐藏关联
高级查询	"找出最近一周修改过的所有文档"	SQL 查询，精准筛选
标签检索	"搜索所有打了'重要'标签的笔记"	按标签聚合，快速分类

✍️ 创建与编辑：AI 帮你写笔记

场景	你说的话	AI 做的事
写日记	"帮我在朝花夕拾里创建今天的日记"	自动创建文档，填入日期
追加内容	"在这篇文档末尾加上一段总结"	精准定位文档末尾，追加内容
批量创建	"帮我创建一个读书笔记模板"	按模板结构批量生成
精确修改	"把文档里的'XX'改成'YY'"	查找替换，精准无误
内容生成	"根据我这篇草稿写一篇正式文章"	读取草稿 → 理解意图 → 生成正文

📁 文档管理：AI 帮你整理"图书馆"

场景	你说的话	AI 做的事
移动文档	"把这个笔记从A文件夹移到B文件夹"	跨笔记本移动
重命名	"帮这篇文档改个名字"	修改文档标题
创建结构	"在阅读札记下创建一个新分类"	创建子文档目录树
批量整理	"把所有未分类的笔记归档到对应文件夹"	智能分类 + 批量移动

📊 数据库操作：AI 帮你管"表格"

思源笔记有一个很强大的功能叫属性视图（Attribute View），本质上就是一个内置数据库。

[td]

场景	你说的话	AI 做的事
创建数据库	"帮我创建一个读书数据库"	创建属性视图，设置字段
添加字段	"加一个评分列"	动态添加列
筛选排序	"按评分从高到低排列"	应用筛选条件和排序规则
批量录入	"把这10本书的信息录入数据库"	批量添加行并填入数据

🃏 闪卡学习：AI 帮你做"记忆大师"

思源内置了间隔重复（Spaced Repetition）功能，Sisyphus 把它也开放给了 AI：

• 创建闪卡："把这段内容做成闪卡"
• 复习卡片："今天该复习哪些卡片？"
• 批量生成："根据我这篇笔记，生成20张问答卡片"
  
  

🏷️ 标签与属性、🗂️ 笔记本管理、📤 导出与资源……

还有更多能力就不一一展开了，包括：

• 标签管理（列出、重命名、删除）
• 笔记本权限控制（只读/可写/可删除）
• Markdown 导出
• 图片 OCR 识别
• 未使用资源清理
  
  

12 个工具，覆盖了你在思源笔记里能做的几乎所有事情。

---

六、安全吗？插画级的权限控制

看到这里你可能会担心：AI 能随便改我的笔记，不会把我的知识库搞乱吧？

放心，这个插件在安全方面做得非常到位：

🔐 笔记本级权限

每个笔记本都可以独立设置权限级别：

[td]

权限	含义	AI 能做的事
none	完全不可见	看都看不到
r	只读	只能看，不能改
rw	读写	可以看，也可以改
rwd	读写删除	完全控制（慎用）

默认情况下，删除操作是被禁止的。 只有你明确授权的笔记本，AI 才能进行高危操作。

🔐 高危操作确认

像删除文档、移动文档、替换内容这类"不可逆"的操作，插件会标记为高危动作，需要用户明确确认后才能执行。

🔐 文档时间线（Git-Like Timeline）

这是我特别想强调的一个功能——文档版本控制。

从 v0.4.0 开始，插件引入了类似 Git 的文档时间线：

• 📸 创建快照：给文档拍一个"快照"
• 🔍 对比差异：查看当前文档和历史快照的区别
• ⏪ 一键回滚：AI 改坏了？没关系，一键恢复到任意历史版本
  
  

这就像给你的每篇笔记都装了一个"时光机"，AI 怎么改你都不用怕。

---

七、fs 工具：AI 的"文件管理器"

这个工具值得单独拿出来说，因为它彻底改变了 AI 和思源笔记的交互方式。

以前的问题： 思源笔记是基于"块"（Block）架构的，每个段落、图片、表格都有一个复杂的块 ID。AI 要操作笔记，必须理解这套复杂的体系。

fs 工具的解决方案： 把思源笔记"伪装"成一个普通的文件系统！

AI 看到的不是一堆块 ID，而是：

/笔记本/子文件夹/笔记标题.md

支持的操作就像操作文件一样直观：

• ls —— 列出目录内容
• tree —— 显示目录树
• read —— 读取文件内容
• write —— 写入内容
• replace —— 替换内容
• rm —— 删除文件
• mv —— 移动文件
• search —— 搜索文件
  
  

这意味着： AI 不需要理解思源底层的块结构，就能像人类一样用自然路径操作笔记。大大降低了使用门槛。

---

八、实战场景：装完之后能干啥？

说了这么多功能，来点实际的。

场景 1：AI 帮你写日报

💬 你："帮我回顾一下我今天在思源里写的笔记，整理成一份工作日报"

🤖 AI：搜索今天创建/修改的文档 → 提取关键内容 → 按时间线整理 → 生成日报 → 写入你的日报笔记本

场景 2：AI 帮你做读书笔记

💬 你："把这段划线内容做成5张闪卡，正面是问题，背面是答案"

🤖 AI：读取内容 → 理解知识点 → 生成问答对 → 批量创建闪卡 → 设置好间隔重复参数

场景 3：AI 帮你整理知识库

💬 你："我有200多篇笔记散落在各个笔记本里，帮我按主题重新分类"

🤖 AI：遍历所有笔记 → 分析内容主题 → 生成分类方案 → 询问确认 → 批量移动整理

场景 4：AI 帮你写公众号文章

💬 你："根据我最近一个月关于 MCP 的学习笔记，帮我写一篇公众号文章"

🤖 AI：搜索相关笔记 → 提取核心观点 → 组织文章结构 → 生成初稿 → 你来润色

（没错，你现在看到的这篇文章，就是 AI 根据我的思路笔记生成的 😄）

场景 5：AI 帮你做知识关联

💬 你："分析一下我的笔记库里，哪些主题之间有关联但我还没有建立双链？"

🤖 AI：扫描全库笔记 → 提取关键词和主题 → 分析语义关联 → 发现隐藏联系 → 建议建立链接

---

九、安装指南：3 分钟搞定

方式一：思源插件市场（推荐）

• 打开思源笔记 → 左侧菜单 → 集市 → 插件
• 搜索 "SiYuan Sisyphus MCP & CLI"
• 点击安装 → 启用插件
• 打开插件设置页 → 选择你要用的 AI 客户端（Claude Desktop / Cursor 等）
• 复制生成的配置，粘贴到对应 AI 工具的配置文件里
  
  

方式二：npm 命令行（极客玩家）

# 全局安装npm i -g siyuan-sisyphus# 初始化配置siyuan-sisyphus init# 测试连接siyuan notebook listMCP 客户端配置示例

以 Claude Desktop 为例，编辑配置文件：

{  "mcpServers": {    "siyuan": {      "command": "node",      "args": ["/你的路径/SiYuan/data/plugins/siyuan-plugins-mcp-sisyphus/mcp-server.cjs"]    }  }}

保存后重启 Claude Desktop，你就会发现工具列表里多出了 12 个思源相关的工具。

---

十、社区生态：持续进化的插件

Sisyphus 是一个活跃维护中的开源项目（MIT 许可证），由社区开发者持续更新迭代。

几个值得关注的点：

• 🔄 更新频繁 —— 从 v0.3 到 v0.4.9，功能持续增强（文档时间线、fs 工具、虚拟 AGENTS.md 等都是近期新增）
• 📦 插件市场可直接安装 —— 在思源笔记的集市里搜索即可，无需手动配置
• 💬 反馈渠道畅通 —— 插件内置了 feedback 工具，AI 和用户都可以直接向开发者提交使用体验和建议
• 📖 文档完善 —— 有独立的文档站，安装配置、使用教程一应俱全
• 🔧 兼容性好 —— 支持桌面端、Docker 部署、移动端，最低兼容思源 2.9.0
  
  

---

十一、我的使用心得：它改变了什么？

装了这个插件之后，我的思源笔记使用方式发生了根本性的变化：

以前： 思源是一个"记录工具"，我手动写、手动整理、手动搜索。

现在： 思源变成了一个"智能知识库"，AI 能帮我：

• 写 —— 生成初稿、扩写缩写、翻译润色
• 找 —— 跨文档搜索、关联分析、知识图谱
• 整 —— 自动分类、批量标签、清理冗余
• 学 —— 生成闪卡、间隔复习、知识测验
  
  

最重要的是：数据始终在我自己手里。

不像云端 AI 笔记工具（Notion AI、Get 笔记等），我的笔记存在我自己的 NAS 上，通过 Docker 部署，AI 通过本地 API 访问——从头到尾，数据不出我的局域网。

---

十二、总结：谁应该用这个插件？

[td]

你是谁	你将获得
思源笔记用户	解锁 AI 能力，让笔记库"活"起来
知识管理爱好者	第二大脑 + AI 助手 = 超级大脑
效率工具玩家	CLI + MCP，无限自动化可能
隐私敏感用户	全本地化，数据不离开你的设备
内容创作者	AI 辅助写作，素材自动整理

如果你也在用思源笔记，这个插件是必装的。 没有之一。

---

📚 相关资源

• 🏠 插件 GitHub 仓库
• 📖 官方文档
• 📦 npm 包
• 🌐 MCP 协议官网
• 📋 MCP 协议规范
  
  

---

写在最后： 知识管理的终极目标，不是记更多的笔记，而是让笔记能够被高效地使用。SiYuan Sisyphus 让 AI 成为了你和知识库之间的桥梁——你负责思考和记录，AI 负责检索和整理。这才是"第二大脑"该有的样子。

---

如果这篇文章对你有帮助，欢迎转发给同样在用思源笔记的朋友。有问题也可以在评论区交流～

赞

看看私信~😘