MCP Personal

🚀 Lifelogger

Lifelogger是一個結合間隔重複學習法的個人知識系統，主要設計用於通過MCP與Claude協同使用。它能幫助你高效地捕捉和留存知識，讓知識管理變得更加輕鬆。

🚀 快速開始

Lifelogger藉助兩個核心概念助力你捕捉和留存知識：

• 條目（Entries）：原始知識，包括事實、筆記、概念等任何你想要記住的內容。
• 卡片（Cards）：用於間隔重複學習的閃卡，可選擇性地與條目關聯。

其理念是將Claude作為交互界面。在你與Claude聊天時，你可以要求它保存有趣的事實、創建閃卡，並對你所學內容進行測驗。Claude會決定如何表述卡片內容以及何時創建卡片，而MCP工具僅負責數據庫操作和調度。

與Claude的示例對話

你：我剛瞭解到地球歷史上共發生過5次大規模滅絕事件，而我們現在可能正處於由人類導致的第6次事件中。

Claude：這是個很重要的事實。要我保存這個內容並創建一些閃卡嗎？

你：好的，保存並創建一張卡片。

Claude：[調用log_entry，然後調用create_card] 完成！我已保存了標記為“科學”和“生態學”的條目，並創建了一張卡片：

• 問題：“地球歷史上發生過多少次大規模滅絕事件？”
• 答案：“5次，目前可能正處於由人類導致的第6次事件中”

之後：

你：考我點東西。

Claude：[調用get_due_cards] 這有一個問題：地球歷史上發生過多少次大規模滅絕事件？

你：5次，我們正處於第6次。

Claude：答對了！感覺如何 —— 簡單、良好、困難還是忘記了？

你：良好。

Claude：[調用record_review，評分=2] 瞭解。你將在4天后再次看到這張卡片。

✨ 主要特性

MCP工具

卡片類型

• 基礎型（basic）：單向問答（問題→答案）。
• 可逆型（reversible）：創建兩張卡片（答案→問題和問題→答案）。
• 填空型（cloze）：填空式風格。

複習評分

複習計劃採用SM - 2算法，這也是Anki所基於的算法。

📦 安裝指南

1. 安裝

pip install -e .

2. 數據庫

設置PostgreSQL並配置連接：

cp .env.example .env
# 在.env中編輯你的DATABASE_URL

運行數據庫遷移：

alembic upgrade head

3. 配置Claude

在你的Claude Desktop的claude_desktop_config.json中添加以下內容：

{
  "mcpServers": {
    "lifelogger": {
      "command": "python",
      "args": ["-m", "lifelogger.mcp.server"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/lifelogger"
      }
    }
  }
}

💻 使用示例

基礎用法

上述與Claude的對話示例就是基礎的使用方式，通過與Claude交互，實現知識的保存、閃卡的創建和複習。

高級用法

如果你想使用Web界面進行條目/卡片瀏覽和複習，可以按照以下步驟操作：

# 終端1 - 後端
export DATABASE_URL="postgresql://..."
uvicorn lifelogger.api.main:app --port 8000

# 終端2 - 前端
cd frontend && npm install && npm run dev

打開 http://localhost:5173

🔧 技術細節

技術棧

• Python 3.11+、FastAPI、SQLAlchemy、Alembic
• PostgreSQL
• MCP Python SDK
• React + Vite（前端）

項目結構

lifelogger/
├── alembic/              # 數據庫遷移
├── frontend/             # React Web界面
├── lifelogger/
│   ├── api/              # FastAPI REST API
│   ├── core/sm2.py       # 間隔重複算法
│   ├── db/               # SQLAlchemy模型
│   └── mcp/server.py     # MCP服務器
└── pyproject.toml