MCP V4x

🚀 微信読書モデルコンテキストプロトコルサーバー（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
   

環境変数の設定

以下の方法で設定できます。

• 方法1：config.jsonを編集する。

  {
    "cookie": "あなたの微信読書のCookieを入力してください",
    "proxy": "http://your-proxy-server:port"
  }
  

• 方法2：環境変数を設定する。

  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の下でオープンソース化されています。