返回市场
MCP服务器阅读

MCP服务器阅读

作者:ChenyqThu140 星标更新:2025-05-16

项目介绍

微信读书 MCP 服务器

一款为微信读书提供 MCP(模型上下文协议)服务的工具,支持将微信读书中的书籍、笔记和划线数据提供给支持 MCP 协议的大语言模型客户端,如 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 服务器用户手册

与 Claude Desktop 集成

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

方法 1:使用 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"
          }
        }
      }
    }
    

方法 2:全局安装后使用

  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. 在 Header 中找到 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
...

许可证

MIT

贡献

欢迎提交 Pull Request 或 Issue 来改进这个项目。