微信读书MCP服务端

微信读书MCP服务端是一个为微信读书提供MCP(Model Context Protocol)服务的工具,支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端,如Claude Desktop。它能够获取用户书架信息、搜索图书、获取图书的笔记和划线,并按章节组织这些数据,便于大语言模型理解和处理。

  • by package
  • 更新于

使用说明

基本能力

产品定位

微信读书MCP服务端是一个连接微信读书和大语言模型的桥梁,提供结构化的书籍和笔记数据。

核心功能

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

适用场景

  • 大语言模型需要访问用户微信读书数据时
  • 需要整理和分析微信读书笔记和划线时
  • 构建基于微信读书数据的知识管理或学习系统

主要工具

  1. get_bookshelf - 获取用户书架上所有书籍
    • 返回书籍基本信息,包括书名、作者、译者和分类等
  2. search_books - 通过关键词检索用户书架上的书籍
    • 支持模糊匹配和精确匹配
    • 可选是否包含详细信息
    • 可设置最大结果数量
  3. get_book_notes_and_highlights - 获取指定书籍的所有划线和笔记
    • 支持按章节组织结果
    • 支持筛选划线样式
    • 返回结构化的数据以便于LLM理解

使用教程

使用依赖

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

安装教程

方式一:通过 npx 使用(最简单,推荐)

  1. 打开Claude Desktop
  2. 进入设置 -> MCP配置
  3. 添加工具,使用以下JSON配置:
    {
      "mcpServers": {
        "mcp-server-weread": {
          "command": "npx",
          "args": ["-y", "mcp-server-weread"],
          "env": {
            "CC_URL": "https://cc.chenge.ink",
            "CC_ID": "您的ID",
            "CC_PASSWORD": "您的密码"
          }
        }
      }
    }
    

方式二:全局安装后使用

  1. 全局安装包:
    npm install -g mcp-server-weread
    
  2. 在Claude配置中使用:
    {
      "mcpServers": {
        "mcp-server-weread": {
          "command": "mcp-server-weread",
          "env": {
            "CC_URL": "https://cc.chenge.ink",
            "CC_ID": "您的ID",
            "CC_PASSWORD": "您的密码"
          }
        }
      }
    }
    

调试方式

  1. 确保Node.js版本符合要求:
    node -v
    
  2. 测试安装是否成功:
    npx mcp-server-weread --help
    
  3. 检查Cookie是否正确配置:
    • 通过浏览器开发者工具获取微信读书Cookie
    • 或正确配置CookieCloud服务