MCP V4x

🚀 微信讀書模型上下文協議服務器（MCP Server）

這是一個用於與微信讀書（WeRead）API交互的工具，旨在助力大語言模型客戶端（LLM clients）獲取並處理微信讀書的數據，可獲取用戶書架信息、搜索特定類別書籍以及獲取指定書籍的筆記和標註。

🚀 快速開始

本工具可幫助大語言模型客戶端與微信讀書API交互，獲取和處理微信讀書的數據。使用前需完成安裝和環境變量配置。

✨ 主要特性

• 獲取書架信息：返回用戶微信讀書賬號下的所有書籍信息，涵蓋書名、作者、閱讀進度等。
• 搜索書籍：依據關鍵詞搜索書架中的書籍，支持模糊匹配。
• 獲取筆記和標註：返回指定書籍的筆記和標註信息，按章節組織。

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協議開源。