第 5 章

MCP 与 AI 接入

2026-09-11更新 2026-09-11

读书笔记插件提供了一组面向阅读数据的 MCP 能力。开启后，支持 MCP 的外部 AI 或 Agent 可以通过思源的 MCP 入口读取书籍、同步、批注、主题、复习队列和诊断信息，适合做阅读回顾、资料检索和状态汇总。

MCP 在插件中默认关闭。它是一个只读入口：不会修改思源笔记，不会写入插件设置，不会创建、删除或调整主题，也不会触发微信读书同步。

第一步：在插件中开启 MCP

进入阅读工作台，在“设置”或相关入口中打开“MCP 服务”，开启“启用 MCP”，然后点击“保存”。正常开启后，状态会显示类似“已开启 · 9/9”，并标注“仅提供只读访问”。

启用和关闭都可以在思源运行期间生效，正常情况下不需要重启思源。关闭后，已经注册的读书笔记 MCP 能力会从思源的 MCP 工具列表中移除。

默认关闭是有意设计

只有你主动打开并保存后，外部 Agent 才能看到这些能力。首次安装、没有启用记录或状态不确定时，插件会保持关闭，不会把未知状态当成已开启。

在支持 MCP 的客户端中，把服务器地址填写为：

http(s)://<你的思源地址>/mcp

这里的地址就是你平时访问思源的地址。插件不会另外启动一个 MCP Server，也不需要单独设置端口或令牌；访问认证沿用思源本身的认证方式。

不同客户端的连接界面和配置格式可能不同，请以客户端自己的 MCP 设置说明为准。教程不提供某个客户端专用的 JSON 配置，因为连接地址和认证方式才是本插件固定的部分。

开启成功后，插件会注册下面 9 项领域能力。它们读取的是插件已经保存的本地阅读数据，并且都带有数量边界或分页限制，不会把整份底层存档一次性暴露给 Agent。

能力	可以读取的内容
`reading_overview`	一份有边界的阅读数据概览，不发起同步，也不访问外部服务
`sync_status`	最近一次已经保存的微信读书同步报告，以及有边界的非成功问题；不是前端正在运行的实时进度
`sync_history`	有边界的微信读书同步历史摘要，不返回完整的每次报告明细
`reading_statuses`	按整理状态、来源、标题、`bookID` 或来源键搜索和分页查看本地书籍整理状态
`reading_inbox`	搜索和分页查看阅读待办中的划线、想法等有限字段
`review_queue`	查看复习队列、到期内容和下一次间隔预览；不会改变复习状态
`reading_topics`	查看主题元数据；明确请求时可以读取有边界的主题内容，但不会创建或修改主题
`reading_annotations`	按来源、书籍、批注类型或文本搜索和分页查看本地历史批注
`diagnostics`	查看有边界的本地缓存和已保存同步诊断；凭据只返回是否存在，不返回密钥或模板

MCP 返回的是稳定的阅读业务数据，不是任意插件存储、任意 SQL、任意文件或任意 HTTP 接口。能力名称稳定，但思源客户端显示的最终工具名称可能由思源生成。

连接完成后，可以直接用自然语言提出阅读相关问题，例如：

AI 可以基于读取到的数据进行归纳、筛选和分组，但如果你希望修改笔记、加入主题、调整复习结果或启动同步，仍然需要回到插件界面手动操作。

只读边界

MCP 不会返回 API Key、思源认证信息、Authorization Header、加密密钥或模板正文，也不能通过这些能力执行任意 SQL、读写任意文件、发起任意网络请求或调用同步流程。

先确认插件设置中的 MCP 已主动开启并保存，再确认客户端连接的是当前思源地址的 /mcp 路径。如果状态不是“已开启 · 9/9”，先处理插件显示的错误；客户端已经建立连接时，也可以重新刷新一次工具列表。

它表示 9 项读书笔记只读能力都已经注册成功。若数量不足或状态显示“服务异常”，说明注册没有完整完成；此时不要把不完整的工具列表当成正常状态，应先在插件设置中重试并查看错误信息。

不会。当前这 9 项能力全部是读取已保存数据的接口；它们不会编辑笔记、改变主题和复习队列，也不会触发微信读书、豆瓣或其他外部服务请求。

MCP 默认关闭。升级到包含 MCP 的版本后，如果你以前没有主动开启，或者升级过程中没有保留启用状态，需要重新进入“MCP 服务”开启并保存；这是安全默认行为，不是数据丢失。

不需要。开关在运行中生效；关闭并保存后，相关能力会注销。重新开启并保存后，9 项只读能力会重新注册。