Learnlog MCP

🚀 learnlog - mcp

LLM学習セッションのプロンプトをローカルに保存し、メタ認知を支援するMCPサーバーです。

LLMを使って学習している間、いつも抱いていた疑問がありました。

"私は本当にこれを理解しているのだろうか？"

AIの説明を読むと、理解したような気になります。うなずきながら「あ、そうだな」と思い、先に進みます。 しかし、数日後に同僚に同じ概念を説明しようとすると、うまく説明できません。 何度も見たはずなのに、実際に話そうとすると、抽象的な感じだけが残っています。

そのとき、私は気づきました。 理解したような感じと本当に理解することは異なるということを。

LLMとの対話中に「分かった」と勘違いしやすいです。 しかし、自分が何を質問したかを振り返ると、実際に何処で立ち往生したかが分かります。 質問の流れを見ると、自分の理解の隙間が明らかになります。

そこで、このツールを作りました。自分の質問を簡単に保存し、後で振り返ることができるツールです。 AIの長い回答ではなく、自分の短い質問だけを集めれば十分です。

私はこのツールを使って、DevOpsとオープンソースエコシステムを深く探求しようと思います。

なぜプロンプトを保存するのか？

LLMで学習する際、私たちは通常出力値（AIの回答）をNotionやメモ帳に保存します。 しかし、考えてみると：

• 同じプロンプトを与えれば、いつでも同じような回答を得ることができます
• 出力値は長くて重いが、プロンプトは短くて軽いです
• 自分が何を質問したかが、つまり自分が何を知らないかを示しています

従来の方法：セッション → AIの回答をコピー → Notionに保存 → 後で見つけるのが難しい

learnlogの方法：セッション → プロンプトを自動保存 → 「今日は何を学んだんだっけ？」 → すぐに確認できる

プロンプトを保存することで、自分が何処で立ち往生したか、何が疑問に思ったかを把握することができます。 これが本当のメタ認知です。

核心理念

1. 入力 > 出力：出力値ではなく、プロンプトを保存します
2. 軽量化：重い回答ではなく、軽い質問のみを保存します
3. メタ認知：「自分が何を質問したか」を通じて学習状況を把握します
4. セッション独立：どの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日に何を学んだ？」

最近の学習状況

「最近1週間の学習状況を見せて」

→ 日付別に質問の数を要約して表示します

高度な使用法

保存場所

~/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"
    }
]

📚 ドキュメント

ツール一覧

活用例

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. 学習パターンの把握

ユーザー：最近1週間の状況を見せて

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