微信读书模型上下文协议服务器（MCP Server）

项目简介

这是一个用于与微信读书（WeRead）API交互的工具，旨在帮助大语言模型客户端（LLM clients）获取并处理微信读书的数据。该工具支持以下功能：

• 获取用户的书架信息
• 搜索特定类别的书籍
• 获取指定书籍的笔记和标注

核心功能

1. 获取书架信息（get_bookshelf）

• 功能描述：返回用户微信读书账号下的所有书籍信息，包括书名、作者、阅读进度等。
• 示例输出：

  {
    "total_books": 208,
    "books": [
      {
        "title": "隐藏的自我",
        "author": "大卫·伊格曼",
        "progress": 100,
        "isbn": "9787536684455"
      },
      ...
    ]
  }
  

2. 搜索书籍（search_books）

• 功能描述：根据关键词搜索书架中的书籍，支持模糊匹配。
• 输入参数：
  • keyword: 需要搜索的关键词
  • max_results (可选): 返回的最大结果数，默认为10
• 示例输出：

  [
    {
      "title": "思考，快与慢",
      "author": "丹尼尔·卡尼曼",
      "progress": 75,
      "isbn": "9787208056432"
    },
    ...
  ]
  

3. 获取笔记和标注（get_book_notes_and_highlights）

• 功能描述：返回指定书籍的笔记和标注信息，按章节组织。
• 输入参数：
  • book_id: 需要查询的书籍ID
• 示例输出：

  {
    "chapter_1": [
      {
        "type": "highlight",
        "content": "系统1的运行是无意识且快速的，不怎么费脑力..."
      },
      {
        "type": "note",
        "content": "系统1负责直觉和快速判断，系统2负责缓慢的理性思考。"
      }
    },
    ...
  }
  

安装与使用指南

先决条件

• 操作系统：支持Linux、Windows、macOS
• 依赖项：
  • Python >=3.6
  • requests库
  • configargparse库

安装步骤

1. 克隆代码仓库到本地：

   git clone https://github.com/yourusername/we-read-mcp.git
   cd we-read-mcp
   

2. 安装依赖项：

   pip install requests configargparse
   

3. 配置环境变量或创建配置文件（见下文）。
4. 运行主程序：

   python main.py
   

环境变量配置

可以通过以下方式配置：

• 方式一：编辑config.json

  {
    "cookie": "填写你的微信读书Cookie",
    "proxy": "http://your-proxy-server:port"
  }
  

• 方式二：设置环境变量

  export WEREAD_COOKIE="填写你的微信读书Cookie"
  export WEREAD_PROXY="http://your-proxy-server:port"
  

使用示例

示例1 - 获取书架信息

python main.py --command get_bookshelf

输出：

{
  "total_books": 208,
  "books": [
    {
      "title": "隐藏的自我",
      "author": "大卫·伊格曼",
      "progress": 100,
      "isbn": "9787536684455"
    },
    ...
  ]
}

示例2 - 搜索书籍

python main.py --command search_books --keyword "心理学" --max_results 5

输出：

[
  {
    "title": "思考，快与慢",
    "author": "丹尼尔·卡尼曼",
    "progress": 75,
    "isbn": "9787208056432"
  },
  ...
]

示例3 - 获取笔记和标注

python main.py --command get_book_notes_and_highlights --book_id "9787208056432"

输出：

{
  "chapter_1": [
    {
      "type": "highlight",
      "content": "系统1的运行是无意识且快速的，不怎么费脑力..."
    },
    {
      "type": "note",
      "content": "系统1负责直觉和快速判断，系统2负责缓慢的理性思考。"
    }
  },
  ...
}

注意事项

• 需要获取有效的微信读书Cookie才能使用。
• 如果需要代理，请确保配置正确的代理信息。
• 使用过程中请遵守微信读书的服务条款。

许可证

本项目采用MIT License协议开源。