MCP Personal

🚀 Lifelogger

間隔復習機能を備えた個人用知識システムで、主にMCPを通じてClaudeと連携して使用することを想定しています。

🚀 クイックスタート

Lifeloggerは、2つの核心的な概念を通じて知識の収集と保持を支援します。

• エントリー：生の知識（事実、メモ、概念など、あなたが覚えたいものすべて）
• カード：間隔復習用のフラッシュカードで、オプションでエントリーにリンクできます。

基本的な考え方は、Claudeをインターフェースとして使用することです。チャット中に、Claudeに興味深い事実を保存したり、フラッシュカードを作成したり、学んだことをクイズ形式で復習するように依頼できます。Claudeがカードの表現方法や作成時期を判断し、MCPツールはデータベース操作とスケジューリングを処理します。

Claudeとの会話例

あなた：地球の歴史の中で大量絶滅イベントは5回起こり、現在人間が引き起こしている6回目の大量絶滅の中にいる可能性があることを知りました。

Claude：それは重要な事実です。これを保存してフラッシュカードを作成しましょうか？

あなた：はい、保存してカードを作ってください。

Claude：[log_entryを呼び出し、次にcreate_cardを呼び出す] 完了！「科学」と「生態学」のタグが付いたエントリーを保存し、カードを作成しました。

• Q: 「地球の歴史の中で何回の大量絶滅イベントが起こりましたか？」
• A: 「5回で、現在人間が引き起こしている6回目の可能性もあります」

その後：

あなた：何かクイズを出してください。

Claude：[get_due_cardsを呼び出す] これが1つです：地球の歴史の中で何回の大量絶滅イベントが起こりましたか？

あなた：5回で、6回目の中にいます。

Claude：正解！感じはどうでしたか？簡単、普通、難しい、それとも忘れてしまいましたか？

あなた：普通

Claude：[rating=2でrecord_reviewを呼び出す] 分かりました。このカードは4日後に再度表示されます。

✨ 主な機能

MCPツール

カードの種類

• 基本：片方向のQ→A形式
• 可逆：2枚のカード（A→BとB→A）を作成します。
• 穴埋め：穴埋め形式

復習評価

スケジューリングには、AnkiがベースとするSM - 2アルゴリズムを使用しています。

📦 インストール

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の外でエントリーやカードを閲覧し、復習するためのReactフロントエンドもあります。

# ターミナル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ウェブUI
├── lifelogger/
│   ├── api/              # FastAPI REST API
│   ├── core/sm2.py       # 間隔復習アルゴリズム
│   ├── db/               # SQLAlchemyモデル
│   └── mcp/server.py     # MCPサーバー
└── pyproject.toml