1. 模型概述:不止于“读书笔记导出器”
MCP Server Weread 是一个基于Model Context Protocol(MCP)开发的开源服务端工具。它充当了AI大模型与你个人微信读书数据之间的“智能桥梁”。简单来说,它让AI助手(如Claude、Cursor内置的AI)能够“看到”并“理解”你在微信读书里的书架、笔记和书评,从而提供更深度的阅读辅助服务。
1.1 能力评估:四大核心工具,解锁阅读数据价值
该项目通过4个标准化的MCP工具(Tools),提供了对微信读书数据的全面访问能力:
| 工具名称 | 功能描述 | 关键参数/输出 |
|---|---|---|
| get_bookshelf | 获取用户全部书架信息 | 返回书籍列表,包含书名、作者、阅读进度等。 |
| search_books | 在书架中搜索特定书籍 | 参数:keyword(关键词)。支持模糊匹配,可设置返回数量。 |
| get_book_notes_and_highlights | 获取指定书籍的全部划线和笔记 | 按章节组织,返回结构化的文本和用户批注。 |
| get_book_best_reviews | 获取书籍的热门书评 | 包含评分、评论内容、点赞数等,支持分页。 |
1.2 技术特点介绍
-
基于MCP协议,天生兼容:采用Anthropic开源的MCP协议,实现了AI应用(Client)与数据源(Server)的标准化解耦。这意味着一经配置,它可以被任何支持MCP的客户端(如Claude Desktop、Cursor)直接调用,无需为每个AI单独适配。
-
双模式认证,持久稳定:创新性地支持CookieCloud服务作为首选认证方式,解决了手动获取的Cookie易过期的问题,实现了Cookie的自动同步与更新,极大提升了使用体验的连续性。
-
上下文就绪,AI友好:返回的数据(如笔记)已按章节结构化,并附有元数据,极大方便了大型语言模型(LLM)进行理解、归纳和再创作,而非提供杂乱无章的原始文本。
1.3 应用场景
-
个人知识管理:让AI助手快速梳理某本书的核心观点,将零散的划线笔记整合成结构化的摘要、思维导图或读书报告。
-
主题研究与写作辅助:例如,要求AI“对比我书架上《思考,快与慢》和《影响力》两本书中关于‘认知偏见’的论述”,为论文或文章提供素材。
-
阅读规划与发现:通过分析书架,让AI推荐接下来该读哪本书,或根据兴趣关键词发现书架上已存在但被忽略的相关书籍。
-
集成到智能体工作流:在Trae等AI智能体平台中,将其作为一个工具集成,创建自动化的“读书笔记生成器”或“阅读看板”。
2. 安装与部署方式:一步一图,全平台指南
部署核心在于:安装Node.js环境 → 获取微信读书认证(Cookie)→ 在AI客户端中配置MCP Server。
2.1 核心环境准备:安装Node.js
这是运行该MCP Server的唯一硬性要求。
-
访问官网:前往 Node.js官方网站,下载LTS(长期支持)版本安装包。
-
验证安装:打开终端(Windows:PowerShell;macOS/Linux:Terminal),输入
node -v和npm -v,显示版本号即成功。
2.2 关键步骤:获取微信读书认证信息(二选一)
强烈推荐方法A:使用CookieCloud(一劳永逸)
-
注册CookieCloud:访问相关服务页面(如默认服务器
https://cc.chenge.ink)注册账户,获取CC_ID(用户UUID)和CC_PASSWORD。 -
安装浏览器插件:在Chrome或Edge商店搜索安装“CookieCloud”插件。
-
配置插件:
-
服务器地址填入
https://cc.chenge.ink或你的自建服务器。 -
点击“自动生成密码”。
-
在“同步域名关键词”中填入
weread。 -
保存后,访问并登录微信读书网页版,在插件中点击“手动同步”。
-
备用方法B:手动获取Cookie(临时使用)
-
在Chrome浏览器中登录微信读书网页版。
-
按F12打开开发者工具,切换到 Network(网络) 标签页。
-
刷新页面,在请求列表中找到任一
weread.qq.com的请求。 -
在 Request Headers(请求头) 中找到
Cookie字段,复制其完整的长字符串。
2.3 配置AI客户端(以Claude Desktop为例)
-
打开配置:在Claude Desktop应用中,进入 Settings(设置) → MCP配置。
-
添加服务器配置:点击“Add Server(添加服务器)”,粘贴以下JSON配置。根据你的认证方式,仅保留一种
env配置。
{ "mcpServers": { "mcp-server-weread": { "command": "npx", "args": ["-y", "@iflow-mcp/mcp-server-weread"], "env": { // 方式一:使用CookieCloud(推荐) "CC_URL": "https://cc.chenge.ink", "CC_ID": "你的CC_ID", "CC_PASSWORD": "你的CC_PASSWORD" // 方式二:使用手动Cookie // "WEREAD_COOKIE": "你复制的长长Cookie字符串" } } } }
-
保存并重启:保存配置,完全重启Claude Desktop。在后续对话中,AI助手即可调用你的微信读书数据。
2.4 各系统特别注意事项
-
Windows系统:
-
建议使用 PowerShell 作为终端。
-
若遇到全局安装权限问题,推荐使用上述
npx配置方式,无需全局安装。
-
-
macOS系统:
-
如果使用手动Cookie方式,在终端配置环境变量时,注意使用正确的shell配置文件(如
.zshrc)。
-
-
Linux系统:
-
部署流程与macOS类似。确保已安装基础的开发工具链(如
build-essential)。
-
3. 配套客户端:连接AI世界的接口
MCP Server Weread 的价值需要通过MCP客户端来体现。以下是主流且兼容性好的客户端:
| 客户端名称 | 类型/特点 | 是否付费 | 配置方式简述 | 下载/获取地址 |
|---|---|---|---|---|
| Claude Desktop | 桌面AI助手,官方MCP支持典范 | 免费 | 图形化界面配置,如第2.3节所述 | Anthropic官网 |
| Cursor | 智能代码编辑器,深度集成AI | 免费/专业版 | 在编辑器设置中找到MCP配置项,添加JSON | Cursor官网 |
| Trae | 国内AI智能体/工作流平台 | 免费 | 在“AI功能管理 → MCP”中手动添加配置 | 应用商店或Trae官网 |
4. 案例讲解:从“囤书”到“产出”的实战
场景:你正在准备一个关于“决策心理学”的分享,想快速整合微信读书里相关书籍的精华。
模拟对话(在已配置的Claude Desktop中):
你:帮我从书架上找出所有和“决策”或“心理学”相关的书。
AI助手:(调用search_books工具)找到了3本书:《思考,快与慢》、《影响力》、《怪诞行为学》。您想深入了解哪一本?
你:把《思考,快与慢》和《怪诞行为学》里所有关于“锚定效应”的笔记和划线找出来,整合成一个对比摘要。
AI助手:(先后调用get_book_notes_and_highlights获取两本书的笔记,然后进行AI分析和整合)
AI输出:
关于“锚定效应”的对比摘要
1. 《思考,快与慢》(丹尼尔·卡尼曼)
核心阐述:锚定效应是系统1(快思考)的典型启发式偏差。人们在对未知量进行估计时,会过度依赖最初获得的“锚点”信息。
你的笔记摘录:“例如,先看到高价商品后,会觉得普通价格商品更便宜——这是营销的常用策略。”
2. 《怪诞行为学》(丹·艾瑞里)核心阐述:锚定效应揭示了人们偏好相对性比较而非绝对价值。最初的锚即使毫无意义,也会持续影响后续判断。
你的划线摘录:“‘羊群效应’与锚定结合,会导致社会性的价格或价值判断扭曲。”
综合对比:卡尼曼从认知心理学根源解释其发生机制,而艾瑞里则更侧重于其在社会与商业行为中的有趣表现和影响。
通过这个案例,你可以看到,MCP Server将AI从“对话伙伴”变成了能直接调用你私人知识库的“研究助理”。
5. 使用成本与商业价值评估
5.1 使用成本
-
金钱成本:完全免费。项目为开源MIT许可证,无需支付任何授权费用。
-
时间与学习成本:中等偏低。对于开发者或技术爱好者,部署配置在1小时内可完成。普通用户可能需要跟随教程花费1-2小时。主要学习成本在于理解MCP概念及Cookie获取流程。
-
维护成本:极低。若采用CookieCloud方案,认证信息可自动更新,几乎无需维护。项目本身轻量,不占用显著系统资源。
5.2 商业与个人价值
-
对个人用户:实现了个人阅读数据的资产化和生产力转化。将封闭平台内的笔记变为可被AI灵活调用的“外脑”,极大提升了阅读的知识留存率和二次创作效率。
-
对开发者生态的示范价值:该项目是MCP协议落地的优秀范例。它展示了如何将一个通用的、高频的互联网服务(微信读书)快速封装成标准的MCP Server,接入蓬勃发展的AI应用生态。这种模式可被复制到其他内容平台(如知乎、豆瓣)。
-
潜在的商业启发:
-
数据服务标准化:如同中“天聚地合”的实践,未来可能有公司专门提供各大平台的标准化MCP Server服务,降低AI应用接入数据源的门槛。
-
垂直场景深化:基于此基础,可以开发更专业的“阅读分析MCP Server”,提供阅读习惯统计、知识图谱构建、推荐书单生成等增值功能。
-
总结:MCP Server Weread 是一个设计精良、解决了实际痛点的开源工具。它技术选型先进(MCP协议),用户体验考虑周全(CookieCloud支持),以极低的成本将个人阅读数据无缝接入了AI时代的生产力流。它不仅是好用的个人工具,更是观察MCP生态如何“连接一切”的绝佳样本。

关注 “悠AI” 更多干货技巧行业动态
