Learnlog MCP

🚀 learnlog - MCP

learnlog - MCP 是一个 MCP 服务器，它可以将大语言模型（LLM）学习会话中的提示词保存到本地，助力用户实现元认知。

🚀 快速开始

安装

1. 克隆仓库并构建

git clone https://github.com/YUJAEYUN/learnlog - mcp.git
cd learnlog - mcp
npm install
npm run build

2. 在 Claude Code 中注册

claude mcp add learnlog - mcp node /path/to/learnlog - mcp/dist/index.js

3. 在 Claude Desktop 中注册（可选）

在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中添加以下内容：

{
    "mcpServers": {
        "learnlog - mcp": {
            "command": "node",
            "args": ["/path/to/learnlog - mcp/dist/index.js"]
        }
    }
}

使用方法

自动保存

当你提出与学习相关的问题时，AI 会自动保存提示词，无需额外告知“保存一下”。

查看学习记录

• 输入 "今天学了什么？" 或 "今天问了什么问题？"，系统将按时间顺序展示今天保存的所有提示词。
• 输入 "2025 - 12 - 20 学了什么？"，可查询特定日期的学习内容。
• 输入 "展示最近一周的学习情况"，系统将按日期汇总展示问题数量。

保存位置

~/learnlog/
└── prompts/
    ├── 2025 - 12 - 20.json
    ├── 2025 - 12 - 21.json
    └── 2025 - 12 - 22.json

每个文件按时间顺序保存了当天的提示词，示例如下：

[
    {
        "prompt": "N + 1 查询问题是什么？",
        "timestamp": "2025 - 12 - 22T10:30:00.000Z"
    },
    {
        "prompt": "那么如何实现预加载（eager loading）？",
        "timestamp": "2025 - 12 - 22T10:35:00.000Z"
    }
]

✨ 主要特性

开发缘由

在使用大语言模型（LLM）学习的过程中，我们常常会产生这样的疑问：“我真的掌握这个知识了吗？”阅读 AI 的解释时，我们似乎理解了内容，会点头认同，但几天后向同事解释相同概念时，却发现难以表达。这让我们意识到，“感觉理解”和“真正理解”是有区别的。

在与 LLM 对话时，我们很容易误以为自己“学会了”，但回顾自己提出的问题，就能发现实际的知识盲点。因此，我们开发了这个工具，它可以轻松保存我们提出的问题，方便日后回顾。我们只需收集自己简短的问题，而无需保存 AI 冗长的回答。

为何保存提示词

在使用 LLM 学习时，我们通常会将 AI 的回答（输出值）保存到笔记软件或记事本中。但仔细思考会发现：

• 相同的提示词总能得到相似的回答。
• 输出值冗长且占用空间，而提示词简洁明了。
• 我们的问题反映了我们的知识盲区。

传统方式：会话 → 复制 AI 回答 → 保存到笔记软件 → 日后查找困难
learnlog 方式：会话 → 自动保存提示词 → 询问“今天学了什么？” → 立即查看

保存提示词能让我们清楚了解自己在哪些方面遇到了困难，以及对哪些内容感兴趣，这才是真正的元认知。

核心哲学

1. 输入 > 输出：保存提示词而非输出值。
2. 轻量化：仅保存简洁的问题，而非冗长的回答。
3. 元认知：通过回顾“我问了什么问题”，了解学习进展。
4. 会话独立：无论使用何种 LLM 或会话，学习记录都会统一保存。

📦 工具列表

💻 使用示例

1. 每日学习回顾

用户：今天学了什么？
AI：📝 今天的问题（5 个）
1. [10:30] N + 1 查询问题是什么？
2. [10:35] 如何实现预加载（eager loading）？
3. [14:20] 何时应该创建索引？
4. [14:45] 复合索引顺序为何重要？
5. [16:00] 如何解读 EXPLAIN ANALYZE 的结果？

通过回顾，我们可以发现今天学习了数据库优化相关知识。

2. 分析学习模式

用户：展示最近一周的学习情况
AI：📊 最近 7 天的学习记录
• 2025 - 12 - 22：5 个问题
• 2025 - 12 - 21：3 个问题
• 2025 - 12 - 20：8 个问题
总共 16 个问题

3. 延续之前的学习

用户：12 月 20 日问了什么问题？
AI：📝 2025 - 12 - 20 的问题（8 个）
1. [09:00] MCP 协议是什么？
2. [09:15] 工具（Tools）、资源（Resources）和提示词（Prompts）有什么区别？
...

回顾后我们可以继续之前关于 MCP 的学习。

📄 许可证

ISC 许可证