lessons-mcp

Claude Code用のMCPサーバーで、過去の教訓を保存・検索し、Claudeが同じ過ちを繰り返さないようにします。全文検索とタグベースのナビゲーションを備えた、永続的な経験ログとして機能します。

クイックスタート

git clone https://github.com/<your>/lessons-mcp
cd lessons-mcp
pip install mcp

~/.claude/mcp.json に追加します：

{
  "mcpServers": {
    "lessons": {
      "command": "python3",
      "args": ["/path/to/lessons-mcp/server/server.py"]
    }
  }
}

ツール

suggest_metadata

書き込み前に利用可能なカテゴリ/タグをプレビューします。既存の状況と提案を返します。

record_lesson

新しい教訓を記録します。タグの再利用の一貫性に関するフィードバックを返します。

search_lessons

過去の教訓を検索します。FTS5（タグ/カテゴリ/タイトル）およびLIKEフォールバック（中国語の本文）を使用します。

list_categories

最近のタグアクティビティを含むカテゴリを閲覧します。

list_tags

カテゴリ内のタグを使用回数とともに閲覧します。

ストレージ

~/.claude/lessons.db（または $LESSONS_DB_PATH）にあるSQLite。 初回実行時に自動作成される1つのテーブルとFTS5インデックスを使用します。

Claude Codeとの統合

1. MCP設定に追加

~/.claude/mcp.json に追加します：

{
  "mcpServers": {
    "lessons": {
      "command": "/Users/karsa/proj/lessons-mcp/.venv/bin/python3",
      "args": ["/Users/karsa/proj/lessons-mcp/server/server.py"]
    }
  }
}

2. MEMORY.mdへのポインタを追加

~/.claude/memory/MEMORY.md に追加します：

## Lessons System
Lessons MCP available. Tools: search_lessons, suggest_metadata, record_lesson,
list_categories, list_tags

3. Claude Codeの再起動

Claude Codeの起動時にサーバーが自動的に開始されます。 ログに lessons-mcp v1.0.0 | ~/.claude/lessons.db | 1 lessons と表示されるはずです。