siyuan

让AI模型通过MCP协议读写思源笔记

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:siyuan。
它的用途是:让AI模型通过MCP协议读写思源笔记
详细介绍见:https://321skill.com/skills/siyuan/
请根据该页面的说明完成安装。

使用示例

“帮我查一下上个月关于‘MCP协议’的所有笔记,并总结成一份摘要。”,它会通过此Skill连接到你的思源笔记,搜索相关文档并生成总结。或者

对AI说:“把刚才我们讨论的项目计划要点,保存到思源笔记的‘项目日志’文档中。”,它会创建或更新指定的笔记内容。

介绍

这个Skill通过集成MCP(Model Context Protocol)协议,为AI模型提供了访问和操作思源笔记数据的能力。它解决了AI助手无法直接与本地或私有化部署的思源笔记数据进行交互的问题,打通了AI与个人知识库之间的壁垒。

使用时,你需要部署此MCP服务器,并在支持MCP协议的AI客户端(如Claude Desktop)中配置连接。配置成功后,AI模型就能在你的授权下,读取思源笔记中的文档、块信息,并执行创建、更新、搜索等操作。

它非常适合深度使用思源笔记作为知识管理工具,并希望AI助手能基于个人笔记内容进行创作、总结或问答的用户。例如,内容创作者、学术研究者或需要频繁整理知识的学生。

请注意,使用前需确保思源笔记服务已启动并可访问。由于涉及数据访问权限,请仅连接你信任的MCP服务器和AI客户端,并注意敏感信息的保护。

核心特点

这是首个将MCP协议与思源笔记深度集成的Skill,实现了AI对思源笔记结构化数据(如文档树、内容块)的原生读写,而非简单的文件访问。它通过思源笔记的API进行精确操作,比通用的文件操作工具更懂思源的数据结构。

注意事项

仅适用于已部署并运行思源笔记服务的环境,无法直接操作其他笔记软件的数据。

常见问题

什么是MCP协议?

MCP(Model Context Protocol)是一种让AI模型安全访问外部工具和数据的开放协议。

我需要安装思源笔记吗?

是的,你需要本地或服务器上已有可访问的思源笔记服务。