项目简介

微信读书MCP服务器是一个轻量级工具，旨在桥接微信读书和支持Model Context Protocol (MCP) 的AI客户端（如Cursor AI, Claude Desktop）。通过此服务器，您可以将微信读书的书籍、笔记和阅读数据无缝集成到您的AI工作流中，实现更智能的阅读分析和知识管理。

主要功能点

书架管理: 获取您的微信读书书架信息，方便AI助手了解您的阅读偏好。
笔记访问: 获取带有笔记的书籍列表以及特定书籍的详细笔记内容（划线、评论），助力AI深入分析阅读内容。
笔记搜索: 根据关键词搜索所有读书笔记，快速定位关键知识点。
最近阅读: 获取最近阅读的书籍和阅读进度，方便AI助手理解您的阅读习惯。

安装步骤

环境准备: 确保您已安装 Node.js (v16+) 和 npm。

下载代码: 使用 git 克隆仓库到本地：

git clone https://github.com/freestylefly/mcp-server-weread.git

进入目录: 进入项目文件夹：

cd mcp-server-weread

安装依赖: 安装项目所需的 npm 包：
```
npm install
```
获取微信读书 Cookie:
- 登录微信读书网页版。
- 打开浏览器开发者工具 (F12 或右键检查 -> 检查)。
- 切换到 "应用程序" (Application) 或 "存储" (Storage) 标签。
- 在左侧菜单中选择 "Cookies"，然后选择 "https://weread.qq.com"。
- 复制所有 Cookie 的值（通常是 'wr_skey' 等）。
配置 Cookie:
- 在项目根目录下创建或编辑 '.env' 文件。
- 将复制的 Cookie 值粘贴到 '.env' 文件中，设置环境变量 'WEREAD_COOKIE'，例如：
```
WEREAD_COOKIE=your_cookie_value_here
```

编译并启动服务器:

npm run build
node build/index.js

服务器成功启动后，将在终端显示运行日志。

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Cursor AI），您需要在客户端的 MCP 配置文件中添加服务器信息。以 Cursor AI 为例，编辑 '~/.cursor/mcp.json' 文件，添加以下配置：

{
  "mcpServers": {
    "weread-notes": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令
      "args": ["/path/to/mcp-server-weread/build/index.js"], // 服务器启动参数，指向编译后的 index.js 文件路径，请替换为实际路径
      "env": {
        "WEREAD_COOKIE": "your_cookie_value_here" // (可选，如果不在 .env 文件中配置，可以在这里配置 Cookie，但不推荐)
      }
    }
  }
}

请注意:

将 '/path/to/mcp-server-weread' 替换为您实际的项目安装路径。
如果您已经在 '.env' 文件中配置了 'WEREAD_COOKIE'，'env' 部分可以省略 'WEREAD_COOKIE' 的配置。

基本使用方法

配置完成后，在支持 MCP 协议的 AI 客户端中，您可以使用以下指令与微信读书数据进行交互：

查询书架: 例如在 AI 客户端中提问： "我的书架上有哪些书？" 或 "请列出我的书架。"
查看书籍笔记: 例如提问： "《思考，快与慢》这本书的笔记是什么？" 或 "我想看《人类简史》的读书笔记。"
搜索笔记内容: 例如提问： "查找关于'认知偏差'的笔记。" 或 "搜索笔记中提到'领导力'的内容。"
获取最近阅读: 例如提问： "我最近读了哪些书？" 或 "最近阅读的书籍有哪些？"

AI 客户端会调用相应的 MCP 工具，并将微信读书的数据返回给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息