微信读书 MCP 在 Cursor 和 Claude 中的配置教程
项目简介
微信读书 MCP Server 是一个为微信读书提供 MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持 MCP 的大语言模型客户端。
功能特点
- 📚 获取书架信息
- 🔍 搜索书架中的图书
- 📝 获取图书的笔记和划线
- ⭐ 获取图书的热门书评
- 📖 支持按章节组织笔记和划线
- 🤖 与支持 MCP 协议的 LLM 客户端无缝集成
前置准备
1. 安装 Node.js
确保您的系统已安装 Node.js 16.x 或更高版本。
2. 获取微信读书 Cookie
方法一：使用 Cookie Cloud（推荐）
-
访问 Cookie Cloud 注册账户
-
获取您的
CC_ID和CC_PASSWORD -
安装浏览器插件：
-
配置 CookieCloud 插件：
- 服务器地址：使用默认服务器
https://cc.chenge.ink或填入自建服务器地址 - 点击"自动生成密码"
- 同步域名关键词中填入 "weread"
- 点击"保存"，然后点击"手动同步"确保配置生效
- [可选] 如果需要插件自动保活，可以在保活中填入
https://weread.qq.com
- 服务器地址：使用默认服务器
方法二：手动获取 Cookie
- 使用 Chrome 浏览器登录微信读书网页版
- 按 F12 打开开发者工具，切换到 Network 标签页
- 刷新页面，在请求列表中找到
weread.qq.com的请求 - 在 Headers 中找到 Cookie 字段，复制其完整内容
在 Cursor 中配置
1. 安装 mcp-server-weread
npm install -g mcp-server-weread
2. 配置 Cursor
在 Cursor 的设置中找到 MCP 配置，添加以下配置：
{
"mcpServers": {
"mcp-server-weread": {
"command": "mcp-server-weread",
"env": {
"CC_URL": "https://cc.chenge.ink",
"CC_ID": "您的CC_ID",
"CC_PASSWORD": "您的CC_PASSWORD"
}
}
}
}
或者使用 npx 方式（无需全局安装）：
{
"mcpServers": {
"mcp-server-weread": {
"command": "npx",
"args": ["-y", "mcp-server-weread"],
"env": {
"CC_URL": "https://cc.chenge.ink",
"CC_ID": "您的CC_ID",
"CC_PASSWORD": "您的CC_PASSWORD"
}
}
}
}
如果使用手动 Cookie 方式：
{
"mcpServers": {
"mcp-server-weread": {
"command": "mcp-server-weread",
"env": {
"WEREAD_COOKIE": "您的微信读书Cookie"
}
}
}
}
在 Claude Desktop 中配置
1. 安装 mcp-server-weread
npm install -g mcp-server-weread
2. 配置 Claude Desktop
- 打开 Claude Desktop
- 进入设置 → MCP 配置
- 添加工具，使用以下 JSON 配置：
{
"mcpServers": {
"mcp-server-weread": {
"command": "mcp-server-weread",
"env": {
"CC_URL": "https://cc.chenge.ink",
"CC_ID": "您的CC_ID",
"CC_PASSWORD": "您的CC_PASSWORD"
}
}
}
}
或者使用 npx 方式：
{
"mcpServers": {
"mcp-server-weread": {
"command": "npx",
"args": ["-y", "mcp-server-weread"],
"env": {
"CC_URL": "https://cc.chenge.ink",
"CC_ID": "您的CC_ID",
"CC_PASSWORD": "您的CC_PASSWORD"
}
}
}
}
使用示例
配置完成后，您可以在 Cursor 或 Claude 中与 AI 助手进行以下对话：
获取书架信息
用户：帮我查看我的微信读书书架
AI：我将获取您的微信读书书架信息...
搜索特定书籍
用户：帮我找关于心理学的书
AI：我将搜索您书架上与心理学相关的书籍...
获取笔记和划线
用户：帮我整理《思考，快与慢》这本书的笔记
AI：我将获取《思考，快与慢》的笔记和划线...
获取热门书评
用户：这本《原则》有哪些热门书评？
AI：我会为您查找《原则》的热门书评...
主要工具功能
- get_bookshelf - 获取用户书架上所有书籍
- search_books - 通过关键词检索用户书架上的书籍
- get_book_notes_and_highlights - 获取指定书籍的所有划线和笔记
- get_book_best_reviews - 获取指定书籍的热门书评
详细使用示例
获取书架信息示例
用户: 帮我查看我的微信读书书架
LLM: 我将获取您的微信读书书架信息。
[LLM调用get_bookshelf工具]
我从您的微信读书书架获取到了208本书籍。以下是部分书籍：
1. 《隐藏的自我》- 大卫·伊格曼
2. 《思考，快与慢》- 丹尼尔·卡尼曼
3. 《人类简史》- 尤瓦尔·赫拉利
...
搜索特定书籍示例
用户: 帮我找关于心理学的书
LLM: 我将搜索您书架上与心理学相关的书籍。
[LLM调用search_books工具，参数为keyword="心理学"]
在您的书架上，我找到了3本与心理学相关的书籍：
1. 《思考，快与慢》- 丹尼尔·卡尼曼（进度：75%）
2. 《乌合之众》- 古斯塔夫·勒庞（进度：50%）
3. 《心理学与生活》- 理查德·格里格（进度：30%）
您想了解哪一本书的更多信息？
获取笔记和划线示例
用户: 帮我整理《思考，快与慢》这本书的笔记
LLM: 我将获取《思考，快与慢》的笔记和划线。
[LLM调用search_books工具，找到书籍ID]
[LLM调用get_book_notes_and_highlights工具]
以下是您在《思考，快与慢》中的笔记和划线（按章节组织）：
第一章：系统1和系统2
- 划线：「系统1的运行是无意识且快速的，不怎么费脑力，没有感觉，完全处于自主控制状态。」
- 您的笔记：「系统1负责直觉和快速判断，系统2负责缓慢的理性思考。」
第三章：锚定效应
- 划线：「锚定效应指的是在不确定情境下进行数字估计时，会过度受到事先接触的不相干数字的影响。」
...
获取热门书评示例
用户: 这本《原则》有哪些热门书评？
LLM: 我会为您查找《原则》的热门书评。
[LLM调用search_books工具，找到书籍ID]
[LLM调用get_book_best_reviews工具]
以下是《原则》的热门书评：
1. 评论者"思考者"（评分：5星）：
"这是一本关于如何思考的书。达利欧将自己多年的经验总结为可操作的原则，帮助我们做出更好的决策。特别喜欢他关于'痛苦+反思=进步'的观点，非常实用。"
👍 182 | 💬 23
2. 评论者"投资学习者"（评分：4星）：
"桥水基金创始人的思想精华，值得反复阅读。书中的工作原则部分对管理者特别有帮助，建议先读生活原则，再读工作原则。"
👍 94 | 💬 12
...
故障排除
常见问题
-
Cookie 过期问题
- 使用 CookieCloud 可以自动同步和更新 Cookie
- 如果使用手动 Cookie 方式，需要定期重新获取
-
连接失败
- 检查网络连接
- 确认 Cookie 或 CookieCloud 配置正确
- 检查 Node.js 版本是否符合要求
-
权限问题
- 确保有足够的权限安装全局包
- 检查防火墙设置
调试方法
- 在终端中直接运行
mcp-server-weread查看错误信息 - 检查环境变量是否正确设置
- 查看 Cursor 或 Claude 的日志文件
注意事项
- 确保您的
CC_ID和CC_PASSWORD保密，避免泄露 - 配置 CookieCloud 后，系统会优先使用 CookieCloud 获取 Cookie，获取失败才会使用
WEREAD_COOKIE环境变量的值 - 建议使用 CookieCloud 方式，可以自动同步和更新 Cookie，避免频繁手动更新
- 微信读书的 Cookie 有效期较短，建议使用 CookieCloud 服务来管理
许可证
MIT
参考链接
更新日志
- 2025-10-18：初始版本，支持基本的微信读书 MCP 功能
- 支持 Cursor 和 Claude Desktop 集成
- 支持 CookieCloud 自动同步
- 支持按章节组织笔记和划线
通过以上配置，您就可以在 Cursor 和 Claude 中无缝使用微信读书的数据了！如有问题，请参考故障排除部分或查看项目 GitHub 仓库的 Issues。
