mcp-server-weread

🚀 微信读书工具开发文档

本工具可助力开发者打造功能完备的微信读书辅助工具，能获取书架数据、管理笔记、搜索书籍与笔记内容、查看最近阅读记录等，为用户提供更便捷的读书体验。

✨ 主要特性

获取书架数据

• 功能描述：获取用户微信读书书架上的所有书籍信息。
• 输入参数：无
• 输出结果：

{
  "bookshelf": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "cover": string,
      "progress": number,
      "readingTime": number,
      "lastReadingDate": number,
      "noteCount": number,
      "url": string
    }
  ]
}

• 实现逻辑：
  1. 调用微信读书API获取书架数据。
  2. 解析返回的JSON数据，提取书籍信息。
  3. 格式化输出结果。

笔记管理

• 功能描述：对用户的笔记进行添加、删除和查询操作。
• 输入参数：
  • bookId：string (必填)
  • chapterUid：string (必填)
  • content：string (必填)
• 输出结果：

{
  "status": number,
  "message": string,
  "data": {
    "noteId": string,
    "bookId": string,
    "chapterUid": string,
    "content": string,
    "createTime": number
  }
}

• 实现逻辑：
  1. 获取指定书籍的笔记列表。
  2. 根据操作类型执行相应的数据库或API操作。
  3. 返回操作结果。

搜索功能

• 功能描述：在书架中搜索书籍或笔记内容。
• 输入参数：
  • keyword：string (必填)
• 输出结果：

{
  "searchResults": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "contentExcerpt": string,
      "type": "book|note",
      "createTime": number
    }
  ],
  "total": number
}

• 实现逻辑：
  1. 遍历所有书籍和笔记内容。
  2. 使用关键词进行全文匹配。
  3. 返回匹配结果并排序。

最近阅读记录

• 功能描述：获取用户最近阅读的书籍列表。
• 输入参数：无
• 输出结果：

{
  "recentReading": [
    {
      "bookId": string,
      "title": string,
      "author": string,
      "cover": string,
      "readingTime": number,
      "progress": number,
      "lastReadingDate": number
    }
  ]
}

• 实现逻辑：
  1. 调用微信读书API获取阅读历史。
  2. 解析并格式化最近阅读数据。
  3. 返回结果。

🔧 技术细节

环境变量管理

• 使用.env文件或系统环境变量存储敏感信息（如Cookie）。
• 支持通过Cookie Cloud服务自动获取最新Cookie。

错误处理

• 实现完善的异常捕获机制，特别是在API调用失败时。
• 提供Cookie过期提醒和自动刷新功能。

性能优化

• 控制API调用频率，避免触发平台限制。
• 引入短期缓存机制，减少重复请求。

MCP协议适配

• 确保工具与MCP（跨平台通信协议）兼容。
• 提供详细的日志记录和错误报告功能。

📈 后续拓展方向

功能扩展

• 实现书籍借阅功能，支持用户间图书共享。
• 开发读书打卡功能，鼓励用户坚持阅读习惯。
• 引入社交互动模块，支持评论、点赞等操作。

技术整合

• 集成AI推荐系统，基于用户阅读历史提供个性化书单。
• 支持多平台数据同步，实现跨设备阅读体验。
• 开发离线阅读功能，优化网络依赖问题。

用户体验优化

• 实现智能书架布局，支持自定义分类和排序。
• 提供多种主题样式，满足不同用户审美需求。
• 开发语音朗读功能，提升阅读便利性。

📚 结语

本开发文档详细介绍了微信读书工具的核心功能模块和技术实现要点。通过遵循本文档的指导，开发者可以快速搭建一个功能完善的读书辅助工具，并在此基础上进行个性化扩展和优化。