Reading Companion

🚀 閱讀伴侶

這是一個分為四個階段的閱讀伴侶，它能幫助你設定閱讀目標、發現書籍、跟蹤閱讀進度，並通過反思深化學習。它作為一個與Claude Desktop集成的MCP（模型上下文協議）服務器運行。

🚀 快速開始

閱讀伴侶是一個能助力你完成閱讀全流程的工具，從設定目標到深入反思，它都能提供幫助。以下是使用前的準備和操作步驟。

安裝

前提條件

• Python 3.10及以上版本
• uv （Python包管理器）
• Claude Desktop

安裝步驟

# 克隆倉庫
git clone https://github.com/aby0/reading-companion
cd reading-companion

# 安裝依賴
uv sync

配置Claude Desktop

將以下內容添加到Claude Desktop的配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reading-companion": {
      "command": "uv",
      "args": ["--directory", "/path/to/reading-companion", "run", "reading-companion"]
    }
  }
}

將 /path/to/reading-companion 替換為你克隆倉庫的實際路徑。 重啟Claude Desktop，你應該能在MCP服務器列表（錘子圖標）中看到“Reading Companion”。

使用方法

初始設置（僅需執行一次）

步驟1：進行訪談

你: "Interview me for my reading goals"

Claude會詢問你的閱讀目標、偏好和背景信息，結束後會保存你的閱讀檔案。

步驟2：提取上下文（可選）

你: "Analyze my reading profile"

Claude會提取更深入的模式以改進推薦。

步驟3：構建你的書籍列表

你: "Build me a reading stack for classic literature"

獲取每個領域的精選書籍推薦。

持續使用

記錄已讀完的書籍

你: "I just finished Anna Karenina by Tolstoy"

反思一本書

你: "I want to reflect on Anna Karenina"

檢查閱讀進度

你: "How's my reading progress?"

獲取下一本推薦書籍

你: "What should I read next?"

手動添加一本書

你: "Add 'War and Peace' to my classic lit stack"

✨ 主要特性

四個階段

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   STAGE 1    │     │   STAGE 2    │     │   STAGE 3    │
│ Interviewer  │ ──▶ │   Context    │ ──▶ │   Syllabus   │
│              │     │   Builder    │     │   Builder    │
│ "Who are you │     │  "Extract    │     │ "Build your  │
│  as a reader"│     │   patterns"  │     │  book stacks"│
└──────────────┘     └──────────────┘     └──────────────┘
       │                                          │
       │              ┌──────────────┐            │
       └────────────▶ │   STAGE 4    │ ◀──────────┘
                      │  Reflection  │
                      │   Partner    │
                      │              │
                      │ "What did    │
                      │  you learn?" │
                      └──────────────┘

1. 訪談者 - 通過對話構建你的閱讀檔案。
2. 上下文構建器 - 從你的檔案中提取更深入的模式。
3. 課程大綱構建器 - 為每個領域創建精選的書籍列表。
4. 反思夥伴 - 幫助處理書籍並跟蹤成長。

可用工具

階段1：訪談者

階段2：上下文構建器

階段3：課程大綱構建器

階段4：反思

作者與模式分析

📦 數據存儲

所有的閱讀數據都存儲在 ~/reading-companion-data/ （與代碼分開）：

~/reading-companion-data/
├── profile.md                    # 你的檔案（人類可讀）
├── profile.json                  # 檔案數據（系統）
├── bookstacks.json               # 所有書籍列表數據（系統）
├── authors.json                  # 作者跟蹤（系統）
├── patterns.json                 # 閱讀模式（系統）
├── connections.json              # 書籍關聯（系統）
│
├── bookstacks/                   # 書籍推薦
│   ├── _index.md                 # 所有書籍列表概述
│   ├── classic_lit.md            # 每個領域一個文件
│   └── neuroscience.md
│
├── progress/                     # 進度跟蹤
│   ├── _current.md               # 帶有進度條的當前狀態
│   ├── _insights.md              # 閱讀模式見解
│   └── reading_log.json          # 結構化日誌（系統）
│
├── authors/                      # 作者檔案
│   ├── _index.md                 # 按親和力排序的所有作者
│   ├── leo-tolstoy.md            # 每個作者一個文件
│   └── james-clear.md
│
└── reflections/                  # 書籍反思
    ├── _index.md                 # 所有已讀書籍索引
    ├── anna-karenina.md          # 每本書一個文件
    └── atomic-habits.md

關鍵特性：所有 .md 文件都是人類可讀的，可以在VS Code、Obsidian或任何文本編輯器中打開。

📚 詳細文檔

自定義

提示語

指導每個階段的提示語位於 reading_companion/prompts/ 目錄下：

• interviewer.md - 訪談的進行方式
• context_builder.md - 檔案的分析方式
• syllabus_builder.md - 書籍的精選方式
• reflection.md - 反思的引導方式 你可以根據自己的喜好自定義這些提示語。

領域

你可以設置任何你想要的閱讀領域，它們不是硬編碼的。在訪談過程中，定義你感興趣的領域，例如：

• 經典文學
• 科幻小說
• 神經科學
• 哲學
• 工程學
• 歷史
• 任何你感興趣的領域！

原則

• 有目的而非隨機 - 每本書都有其目的。
• 注重學習而非單純閱讀 - 反思與閱讀同樣重要。
• 追求進步而非完美 - 穩步前進勝過雄心勃勃。
• 個性化而非大眾化 - 適合你的才是最好的，而不是暢銷書榜單。

故障排除

“Reading Companion未在Claude Desktop中顯示”

• 檢查 claude_desktop_config.json 中的路徑是否正確。
• 重啟Claude Desktop。
• 檢查MCP日誌是否有錯誤。

“未找到檔案”

• 先運行 start_interview 創建你的檔案。

“未找到領域”

• 檢查你的領域ID是否與檔案中的一致。
• 使用 get_profile 查看可用的領域。

開發

直接運行服務器進行測試：

uv run reading-companion

使用MCP檢查器進行測試：

npx @modelcontextprotocol/inspector uv run reading-companion

📄 許可證

本項目採用MIT許可證。