麦格配书读服务器

Name: 麦格配书读服务器
Author: freestylefly

作者：freestylefly485 星标更新：2025-05-18

安装使用来源：spider==github.com

项目介绍

技术文档摘要

<p align="center"><img src="https://gips3.baidu.com/it/u=814754997,2849182183&fm=3081&app=3081&f=PNG?w=1536&h=478" alt="MaxKB" width="300" /></p> <h3 align="center">一个为微信读书提供 MCP 服务的工具</h3> <p align="center"> <a href="https://opensource.org/license/MIT"><img src="https://img.shields.io/github/license/freestylefly/mcp-server-weread?color=rgb(25%2C%20121%2C%20255)" alt="The MIT License"></a> <a href=""><img src="https://img.shields.io/github/forks/freestylefly/mcp-server-weread?color=green" alt="Forks"></a> <a href="https://canghecode.com/"><img src="https://img.shields.io/badge/介绍-%E5%AE%98%E7%BD%91-green" alt="Official"></a> <a href="https://github.com/laigeoffer/pmhub"><img src="https://img.shields.io/github/stars/freestylefly/mcp-server-weread?style=flat-square&color=rgb(25%2C%20121%2C%20255)" alt="Stars"></a> <a href="https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ"><img src="https://img.shields.io/badge/WeReadMCP-教程-blue" alt="Experience"></a> </p>

微信读书 MCP 服务器是一个为微信读书提供 MCP（模型上下文协议）服务的工具，支持将微信读书的书籍、笔记和高亮数据传递给兼容 MCP 的大型语言模型客户端，如 Cursor 和 Claude Desktop。

功能

获取微信读书书架上的书籍信息
在书架上搜索书籍
获取书籍的笔记和高亮内容
获取热门书籍评论
支持按章节组织笔记和高亮
无缝集成支持 MCP 协议的 LLM 客户端

主要工具

get_bookshelf 获取用户书架上的所有书籍
- 返回书籍的基本信息，包括标题、作者、译者和类别
search_books 根据关键词在用户的书架上搜索书籍
- 支持模糊匹配和精确匹配
- 可选包含详细信息
- 可设置最大结果数量
get_book_notes_and_highlights 获取指定书籍的所有高亮和笔记
- 支持按章节组织结果
- 支持过滤高亮样式
- 返回结构化数据以方便 LLM 理解
get_book_best_reviews 获取指定书籍的热门评论
- 支持设置返回的数量
- 支持分页浏览
- 翻译的内容包括评分、点赞数和评论者信息

安装和使用

需求

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

安装教程

请帮我翻译原文内容

集成到 Claude Desktop

有多种方法可以集成到 Claude Desktop：

方法 1：通过 npx 使用（最简单，推荐）

打开 Claude Desktop
转到设置 -> MCP 配置

使用以下 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：全局安装后使用

全局安装包：
```
npm install -g mcp-server-weread
```

在 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 可以通过以下步骤获得：

使用 Chrome 浏览器登录微信读者网页版
按 F12 打开开发者工具并切换到 Network 标签
刷新页面并在请求列表中找到 weread.qq.com 的请求
在 Headers 中找到 Cookie 字段并复制其全部内容
将复制的内容添加到 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
...

9. 友情链接

mcp-server-weread 一个为微信读书提供 MCP（模型上下文协议）服务的工具，支持将微信读书的书籍、笔记和高亮数据传递给兼容 MCP 的大型语言模型客户端，如 Claude Desktop。
CodeCanvas 该代码仓库汇集了作者苍何多年互联网行业 Java 开发经验，旨在提供清晰详细的教程，重点在于 Java 核心内容。💪🏻
PmHub PmHub 是基于 SpringCloud & LLM 的微服务智能项目管理系统。该项目旨在帮助同行快速掌握微服务/分布式项目的架构设计和开发流程。如果您希望在校园招聘或社会招聘中获得满意的 offer，PmHub 将是一个很好的选择。

X. 致谢

本项目是从 ChenyqThu 的mcp-server-weread项目 fork 出来的，经过一些小改动后突然走红。请同时在原作者的 GitHub 上给原项目点赞。此外，我将继续关注 ChenyqThu 的新更新，项目将持续维护教程更新。感谢您的支持。

11. 星标趋势图

十二. 官方账号

在微信搜索苍何或扫描下方二维码关注苍何原创官方账号，回复 AI 可以与超过 5000 名朋友一起讨论 AI 并学习 MCP。

苍何微信公众号