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