使用说明

项目简介

微信读书 MCP 服务器是一个连接微信读书和 MCP 客户端（如 Claude Desktop、Cursor AI 等）的桥梁。它允许您在支持 MCP 协议的 AI 客户端中无缝访问您的微信读书书架、阅读笔记和书籍信息，从而实现更智能的阅读和知识管理体验。

主要功能点

获取书架信息：快速查看您的微信读书书架上有哪些书籍。
获取笔记本列表：列出所有您在微信读书中记录过笔记的书籍。
获取书籍笔记：获取指定书籍的完整笔记内容，包括划线和评论，并按章节组织。
获取书籍详情：查询书籍的详细信息，如作者、简介、评分等。
搜索笔记内容：在所有读书笔记中搜索包含特定关键词的内容。
获取最近阅读：查看您最近阅读的书籍和阅读进度。

安装步骤

环境准备：确保已安装 Node.js (v16+) 和 npm。
克隆仓库：'git clone https://github.com/ChenyqThu/mcp-server-weread.git'
进入目录：'cd mcp-server-weread'
安装依赖：'npm install'
获取微信读书 Cookie：
- 登录微信读书网页版 (https://weread.qq.com/)。
- 打开浏览器开发者工具（F12 或右键检查）。
- 切换到 "应用程序" 或 "Application" 标签。
- 在左侧 "存储" 下找到 "Cookies"。
- 选择 "https://weread.qq.com"。
- 复制所有 Cookie 值 (通常是 'wr_skey' 和 'wr_vid' 等)。
配置环境变量：
- 在项目根目录下创建或编辑 '.env' 文件。
- 设置微信读书 Cookie：'WEREAD_COOKIE=你复制的cookie值' (粘贴复制的所有 Cookie 值)。
启动服务器：
- 编译代码：'npm run build'
- 启动服务器：'node build/index.js'

服务器配置

在 MCP 客户端的配置文件（例如 Cursor AI 的 '~/.cursor/mcp.json'）中，添加以下服务器配置：

{
  "mcpServers": {
    "weread-server": {
      "command": "node",
      "args": ["/path/to/mcp-server-weread/build/index.js"],
      "env": {
        "WEREAD_COOKIE": "你的微信读书cookie"  // 建议此处使用环境变量，实际 cookie 值配置在 .env 文件中
      }
    }
  }
}

配置参数说明:

'"weread-server"': 服务器名称，可以自定义。
'"command": "node"': 启动服务器的命令，使用 Node.js 运行时。
'"args": ["/path/to/mcp-server-weread/build/index.js"]': 服务器启动参数，指向编译后的 'index.js' 文件路径，请替换 '/path/to/mcp-server-weread' 为实际的项目安装路径。
'"env": { "WEREAD_COOKIE": "你的微信读书cookie" }': 环境变量配置，'WEREAD_COOKIE' 用于传递微信读书 Cookie，建议直接在 '.env' 文件中配置，此处仅作为示例。

基本使用方法

确保 MCP 服务器已成功启动。
在 MCP 客户端中配置并连接到 'weread-server'。
在客户端中，您可以使用自然语言指令调用服务器提供的工具，例如：
- "我的书架上有哪些书？" (对应 'get_bookshelf' 工具)
- "我想看《思考，快与慢》的笔记" (对应 'get_book_notes' 工具，需要提供书名或 bookId)
- "搜索一下关于'领导力'的笔记" (对应 'search_notes' 工具，关键词为 "领导力")
- "我最近在读什么书？" (对应 'get_recent_reads' 工具)

请参考仓库 README 文件和代码注释获取更详细的信息和使用示例。

关键词