一个为微信读书提供 MCP 服务的工具

---

微信读书 MCP Server 是一个为微信读书提供 MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Cursor、Claude Desktop。

功能特点

• 从微信读书获取书架信息
• 搜索书架中的图书
• 获取图书的笔记和划线
• 获取图书的热门书评
• 支持按章节组织笔记和划线
• 与支持MCP协议的LLM客户端无缝集成

主要工具

1. get_bookshelf - 获取用户书架上所有书籍

   • 返回书籍基本信息，包括书名、作者、译者和分类等

2. search_books - 通过关键词检索用户书架上的书籍

   • 支持模糊匹配和精确匹配
   • 可选是否包含详细信息
   • 可设置最大结果数量

3. get_book_notes_and_highlights - 获取指定书籍的所有划线和笔记

   • 支持按章节组织结果
   • 支持筛选划线样式
   • 返回结构化的数据以便于LLM理解

4. get_book_best_reviews - 获取指定书籍的热门书评

   • 支持设置返回数量
   • 支持分页浏览
   • 包含评分、点赞数和评论者信息

安装与使用

先决条件

• Node.js 16.x 或更高版本
• 微信读书账号和有效的Cookie

安装教程

详见：

• 用微信读书MCP在Cursor中构建私人图书馆，太哇塞了！
• Weread MCP Server 使用指南

与Claude Desktop集成

有多种方式可以与Claude Desktop集成：

方式一：通过 npx 使用（最简单，推荐）

1. 打开Claude Desktop
2. 进入设置 -> MCP配置
3. 添加工具，使用以下JSON配置：

   {
     "mcpServers": {
       "mcp-server-weread": {
         "command": "npx",
         "args": ["-y", "mcp-server-weread"],
         "env": {
           // 方式1：使用Cookie Cloud（推荐）
           "CC_URL": "https://cc.chenge.ink",  // Cookie Cloud的URL
           "CC_ID": "您的ID",                   // Cookie Cloud的ID
           "CC_PASSWORD": "您的密码"            // Cookie Cloud的密码
           
           // 或方式2：直接提供Cookie
           // "WEREAD_COOKIE": "您的微信读书Cookie"
         }
       }
     }
   }
   

方式二：全局安装后使用

1. 全局安装包：

   npm install -g mcp-server-weread
   

2. 在Claude配置中使用：

   {
     "mcpServers": {
       "mcp-server-weread": {
         "command": "mcp-server-weread",
         "env": {
           // 同上方式配置环境变量
         }
       }
     }
   }
   

提示：直接在Claude配置中提供环境变量的方式更加方便，无需设置.env文件，推荐使用。

CookieCloud 配置说明

为了解决 Cookie 频繁过期，需要重新获取并更新环境变量的问题。本项目支持 CookieCloud 服务来自动同步和更新 Cookie。CookieCloud 是一个开源的跨浏览器 Cookie 同步工具，支持自建服务器。

配置步骤：

安装浏览器插件 Edge商店：CookieCloud for Edge Chrome商店：CookieCloud for Chrome

配置 CookieCloud 插件

服务器地址：使用默认服务器 https://cc.chenge.ink 或填入自建服务器地址 点击 "自动生成密码" 同步域名关键词中填入 "weread" 点击"保存" ，然后点击 "手动同步"确保配置生效 [可选] 如果需要插件自动保活，可以在保活中填入 https://weread.qq.com，插件会自动刷新 Cookie

在MCP Json中配置CookieCloud变量： CC_URL=你的CookieCloud服务器地址 （或使用我的默认服务器地址 https://cc.chenge.ink ） CC_ID=你的CookieCloud用户UUID CC_PASSWORD=你的CookieCloud密码 注意：配置 CookieCloud 后，系统会优先使用 CookieCloud 获取 Cookie，获取失败才会使用 WEREAD_COOKIE 环境变量的值。

Cookie获取方法

微信读书的Cookie可以通过以下步骤获取：

1. 使用Chrome浏览器登录微信读书网页版
2. 按F12打开开发者工具，切换到Network标签页
3. 刷新页面，在请求列表中找到weread.qq.com的请求
4. 在Headers中找到Cookie字段，复制其完整内容
5. 将复制的内容添加到MCP Json 或 .env文件的WEREAD_COOKIE变量中

使用示例

以下是一些与LLM对话的示例：

获取书架信息

用户: 帮我查看我的微信读书书架
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
...

九、友情链接

• mcp-server-weread ：🚀一个为微信读书提供MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Claude Desktop。
• CodeCanvas ：📚本代码仓库是作者苍何多年从事一线互联网Java开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。💪🏻
• PmHub ：🔥PmHub 是一套基于 SpringCloud & LLM 的微服务智能项目管理系统，这个项目旨在帮助小伙伴们快速掌握微服务/分布式项目的架构设计和开发流程，如果想在校招或者社招中拿到一个满意的 offer，PmHub 将是一个非常 nice 的选择。

十、鸣谢

此项目 fork 自 ChenyqThu 的mcp-server-weread项目，做了一些小修改，突然就🔥了，这里也请大家去作者GitHub原项目上star，另外ChenyqThu新的更新我也会做同步，项目也会保持使用教程的更新，感谢大家的喜欢。

十一、star 趋势图

十二、公众号

微信搜 苍何 或扫描下方二维码关注苍何的原创公众号，回复 AI 即可和 5000+ 好友一同探讨AI，一同学习MCP。

十三、许可证

MIT License (MIT)

---

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Copyright (c) 2025-2026 mcp-server-weread

mcp-server-weread 快速上手指南

mcp-server-weread 是一个为微信读书提供 MCP（Model Context Protocol）服务的工具，可将您的书架、笔记和划线数据无缝接入支持 MCP 的 AI 客户端（如 Claude Desktop、Cursor）。

1. 环境准备

在开始之前，请确保满足以下前置条件：

• 运行环境：安装 Node.js 16.x 或更高版本。
• 账号凭证：拥有微信读书账号，并获取有效的 Cookie。
  • 获取方法：登录 微信读书网页版 -> 按 F12 打开开发者工具 -> Network 标签 -> 刷新页面 -> 点击 weread.qq.com 请求 -> 复制 Request Headers 中的 Cookie 字段内容。
• 推荐方案：为避免 Cookie 频繁过期，强烈建议配置 CookieCloud 自动同步（详见下文配置说明）。

2. 安装与配置

本项目推荐通过 npx 直接运行，无需全局安装，配置最为简便。以下以 Claude Desktop 为例进行配置。

步骤一：打开配置文件

在 Claude Desktop 中进入 Settings (设置) -> Developer (开发者) -> Edit Config (编辑配置)，打开 claude_desktop_config.json 文件。

步骤二：添加 MCP 服务配置

将以下 JSON 配置添加到 mcpServers 对象中。您可以根据实际情况选择 CookieCloud 模式（推荐）或 直接 Cookie 模式。

方式 A：使用 CookieCloud（推荐，自动保活）

需先在浏览器安装 CookieCloud 插件并同步微信读书 Cookie。

{
  "mcpServers": {
    "mcp-server-weread": {
      "command": "npx",
      "args": ["-y", "mcp-server-weread"],
      "env": {
        "CC_URL": "https://cc.chenge.ink",
        "CC_ID": "您的 CookieCloud ID",
        "CC_PASSWORD": "您的 CookieCloud 密码"
      }
    }
  }
}

方式 B：直接使用 Cookie（需定期手动更新）

如果您未使用 CookieCloud，可直接填入获取到的 Cookie 字符串。

{
  "mcpServers": {
    "mcp-server-weread": {
      "command": "npx",
      "args": ["-y", "mcp-server-weread"],
      "env": {
        "WEREAD_COOKIE": "您的微信读书完整 Cookie 字符串"
      }
    }
  }
}

注意：保存配置文件后，重启 Claude Desktop 即可生效。系统会优先尝试通过 CookieCloud 获取凭证，若失败则使用 WEREAD_COOKIE。

CookieCloud 简易配置流程

1. 安装插件：在 Chrome/Edge 商店搜索并安装 "CookieCloud"。
2. 设置同步：
   • 服务器地址：使用默认 https://cc.chenge.ink 或自建地址。
   • 同步域名关键词：填入 weread。
   • 点击“自动生成密码”并保存。
3. 获取凭证：记录生成的 ID 和 密码，填入上述 JSON 配置的 CC_ID 和 CC_PASSWORD 中。

3. 基本使用

配置完成后，您可以在对话框中直接与 AI 交互，调用微信读书数据。

示例 1：查看书架

询问 AI 您的书架情况，它将自动调用 get_bookshelf 工具。

用户：帮我看看我的微信读书书架里有哪些书？

AI：我已获取到您的书架信息，共有 208 本书。其中包括：

1. 《隐藏的自我》- 大卫·伊格曼
2. 《思考，快与慢》- 丹尼尔·卡尼曼 ...

示例 2：搜索书籍

通过关键词查找特定书籍。

用户：帮我找一下书架里关于“心理学”的书。

AI：正在搜索...找到了 3 本相关书籍：

1. 《思考，快与慢》（进度 75%）
2. 《乌合之众》（进度 50%） ...

示例 3：整理笔记与划线

让 AI 总结某本书的笔记，它将调用 get_book_notes_and_highlights 并按章节整理。

用户：帮我整理《思考，快与慢》这本书的笔记和划线。

AI：以下是该书的结构化笔记： 第一章：系统 1 和系统 2

• 💡 划线：「系统 1 的运行是无意识且快速的...」
• 📝 笔记：系统 1 负责直觉，系统 2 负责理性思考。 ...

示例 4：查看热门书评

获取书籍的社区评价。

用户：《原则》这本书有哪些热门书评？

AI：为您找到以下高赞书评：

1. 用户"思考者" (5 星)：这是一本关于如何思考的书... (👍 182) ...