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. ユーザー体験の最適化

• インテリジェントな書架レイアウトを実現し、カスタム分類とソートをサポートします。
• 複数のテーマスタイルを提供し、異なるユーザーの審美ニーズを満たします。
• 音声読み上げ機能を開発し、読書の利便性を向上させます。

まとめ

この開発ドキュメントでは、微信読書ツールの核心機能モジュールと技術実装の要点を詳細に説明しました。このドキュメントに従って、開発者は機能が充実した読書支援ツールを迅速に構築し、その上で個別化の拡張と最適化を行うことができます。