
WonderPen 现已支持 MCP 服务
WonderPen 桌面版 3.1.3 版增加了 MCP 支持,这是一个重要更新,可以使用各个支持 MCP 的 AI 助手应用连接 WonderPen 了。
什么是 MCP?
MCP 的全名是 Model Context Protocol,作用是让 AI 应用连接外部系统。
WonderPen 没有内置 AI 服务,但集成了 MCP 接口,你可以使用支持 MCP 的本地 AI 应用访问和操作 WonderPen 中的数据。
简单来说,就是 WonderPen 开放了接口,让第三方 AI 应用可以访问 WonderPen 中的内容。
注:只有桌面版支持 MCP。
可以用 MCP 做什么?
连接 MCP 服务之后,理论上你可以让 AI 对 WonderPen 中的数据做任意分析和操作。比如,你可以在 AI 客户端中让 AI:
帮我读取当前章节,分析本章的节奏是否合理
帮我总结当前章节的主要内容,并生成一段章节简介
帮我检查全文中是否频繁使用了某些词语或句式
帮我读取目录,对章节重新编号
帮我整理“林夏”这个角色的人物小传,包括出场章节、关系和关键事件
帮我检查“虫洞电话”这个道具在哪些章节出现,以及相关伏笔是否已经回收?
帮我根据当前章节内容,生成下一章的几个可能发展方向
我今年一共写了多少字?
使用 MCP 时我的数据安全吗?
MCP 服务连接的是你指定的 AI 服务,你可以选择信任的服务,比如 DeepSeek,或者架设本地模型。
使用 MCP 服务和直接与 AI 对话有什么不同?
MCP 服务提供了整个文档库数据的访问和操作接口,通过 MCP 服务,AI 可以“看见”整个文档库的内容,并在需要时自动查询上下文信息,而不用每次都手工复制粘贴大量信息到对话框中。
同时,通过 MCP 接口,AI 可以直接修改文档库中的内容,不用再手工粘贴回去。
如何在 WonderPen 中开启 MCP 服务?
MCP 服务在 WonderPen 桌面版 3.1.3 中开始支持,可于设置 → 高级 → API 面板启用,如下图所示:

详细设置如下图所示:

其中最重要的是 MCP 服务地址(默认是 http://127.0.0.1:8022/mcp)和 API Token,后续配置中会用到它们。
如何在 AI 客户端中使用?
你可以在任何支持 MCP 服务的 AI 客户端中连接 WonderPen 的 MCP 服务,比如 Codex、Claude、Cursor、Trae 等。
如果觉得 Codex 等工具太专业,也可以使用 Cherry Studio 等更易用的客户端。下面以 Cherry Studio 为例示范一下配置和用法。
在 Cherry Studio 中使用
Cherry Studio 是一款国产 AI 助手应用,支持接入几乎所有主流 AI 模型,也支持 MCP 服务,可以与 WonderPen 一起使用。
安装 Cherry Studio
可以点击下面的链接下载安装 Cherry Studio:
添加 WonderPen MCP 服务
打开 Cherry Studio 的 设置 界面,在左边点击 MCP 服务器,然后添加右上角的 添加 按钮,然后点击 快速创建。如下图所示:

随后填写相关信息,如下图所示:

几个主要字段说明:
名称:这个 MCP 服务的名称,填写
WonderPen或WonderPen MCP即可,你也可以改为其他你喜欢的名称,比如妙笔,后续在与 AI 的对话中可使用这个名称指定 MCP 服务类型:固定选择
可流式传输的 HTTP (streamableHttp)URL:在 WonderPen 后台看到的 MCP 服务的地址,默认是
http://127.0.0.1:8022/mcp请求头:形如
Authorization=Bearer wp-xxx的字符串,其中wp-xxx即是 WonderPen 设置面板中的 API Token
其余字段可不填或使用默认。
选择 AI 模型
不同的模型使用起来体验可能会有较大的差别,如果你要执行比较复杂的操作,建议尽量使用强大的模型,比如 DeepSeek v4 Pro。
在对话中,可以点击下图红框的位置切换模型。

注意:部分高级模型需要另外的账号或 API 密钥,可去对应的站点注册、充值,以获得相关权限。
在对话中添加 MCP 服务器
接下来,在 Cherry Studio 中打开一个对话,在对话框下方的工具栏中点击那个锤子图标,手动将 WonderPen MCP 服务器添加进来。如下图所示:


开始对话
配置好模型以及 MCP 服务之后,就可以开始通过 AI 对话和 WonderPen 交互了,如下图所示:

AI 可以读取整个文档库中的所有数据,也知道当前打开的章节是哪个,光标的位置,以及选中的文字。
你可以让 AI 读取或修改文档,文档被修改之后编辑器中会自动刷新。
也可以让 AI 创建文档或调整目录,甚至还可以访问右侧的备注、快照以及卡片列表等信息。
一些说明
使用 MCP 服务的时候,需要保持 WonderPen 应用开启,一旦 WonderPen 退出,对应的 MCP 服务也会关闭,也就无法继续使用 AI 交互了。
安全起见,MCP 服务只可访问 WonderPen 当前打开的文档库,无法访问或修改未打开的文档库内容。
如果要让 AI 对文档库做较大改动,在开始之前可先手动生成一个备份,遇到问题可随时恢复。