MCP Server Weread

🚀 微信讀書工具開發文檔

本工具旨在為開發者提供便捷的方式來與微信讀書進行交互，涵蓋了獲取書架數據、筆記管理、搜索功能以及最近閱讀記錄等核心功能。通過使用本工具，開發者能夠快速搭建一個功能完善的讀書輔助工具。

🚀 快速開始

本工具主要包含獲取書架數據、筆記管理、搜索功能和最近閱讀記錄等功能模塊，下面將詳細介紹各模塊的功能及實現邏輯。

✨ 主要特性

1. 獲取書架數據

• 功能描述：獲取用戶微信讀書書架上的所有書籍信息。
• 輸入參數：無
• 輸出結果：

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

• 實現邏輯：
  1. 調用微信讀書API獲取書架數據。
  2. 解析返回的JSON數據，提取書籍信息。
  3. 格式化輸出結果。

2. 筆記管理

• 功能描述：對用戶的筆記進行添加、刪除和查詢操作。
• 輸入參數：
  • 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. 返回操作結果。

3. 搜索功能

• 功能描述：在書架中搜索書籍或筆記內容。
• 輸入參數：
  • keyword: string (必填)
• 輸出結果：

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

• 實現邏輯：
  1. 遍歷所有書籍和筆記內容。
  2. 使用關鍵詞進行全文匹配。
  3. 返回匹配結果並排序。

4. 最近閱讀記錄

• 功能描述：獲取用戶最近閱讀的書籍列表。
• 輸入參數：無
• 輸出結果：

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

• 實現邏輯：
  1. 調用微信讀書API獲取閱讀歷史。
  2. 解析並格式化最近閱讀數據。
  3. 返回結果。

🔧 技術細節

1. 環境變量管理

• 使用.env文件或系統環境變量存儲敏感信息（如Cookie）。
• 支持通過Cookie Cloud服務自動獲取最新Cookie。

2. 錯誤處理

• 實現完善的異常捕獲機制，特別是在API調用失敗時。
• 提供Cookie過期提醒和自動刷新功能。

3. 性能優化

• 控制API調用頻率，避免觸發平臺限制。
• 引入短期緩存機制，減少重複請求。

4. MCP協議適配

• 確保工具與MCP（跨平臺通信協議）兼容。
• 提供詳細的日誌記錄和錯誤報告功能。

📚 詳細文檔

後續拓展方向

1. 功能擴展

• 實現書籍借閱功能，支持用戶間圖書共享。
• 開發讀書打卡功能，鼓勵用戶堅持閱讀習慣。
• 引入社交互動模塊，支持評論、點贊等操作。

2. 技術整合

• 集成AI推薦系統，基於用戶閱讀歷史提供個性化書單。
• 支持多平臺數據同步，實現跨設備閱讀體驗。
• 開發離線閱讀功能，優化網絡依賴問題。

3. 用戶體驗優化

• 實現智能書架佈局，支持自定義分類和排序。
• 提供多種主題樣式，滿足不同用戶審美需求。
• 開發語音朗讀功能，提升閱讀便利性。

結語

本開發文檔詳細介紹了微信讀書工具的核心功能模塊和技術實現要點。通過遵循本文檔的指導，開發者可以快速搭建一個功能完善的讀書輔助工具，並在此基礎上進行個性化擴展和優化。