lessons-mcp

Ein MCP-Server für Claude Code, der gewonnene Erkenntnisse speichert und durchsucht, damit Claude vergangene Fehler nicht wiederholt. Betrachten Sie es als ein persistentes Erfahrungsprotokoll mit Volltextsuche und tag-basierter Navigation.

Schnellstart

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

Fügen Sie dies zu ~/.claude/mcp.json hinzu:

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

Tools

suggest_metadata

Vorschau verfügbarer Kategorien/Tags vor dem Schreiben. Gibt die bestehende Landschaft + Vorschläge zurück.

record_lesson

Eine neue Erkenntnis aufzeichnen. Gibt Feedback zur Konsistenz bei der Wiederverwendung von Tags zurück.

search_lessons

Vergangene Erkenntnisse durchsuchen. FTS5 (Tags/Kategorie/Titel) + LIKE-Fallback (chinesischer Textkörper).

list_categories

Kategorien mit kürzlicher Tag-Aktivität durchsuchen.

list_tags

Tags innerhalb einer Kategorie mit Nutzungshäufigkeit durchsuchen.

Speicherung

SQLite unter ~/.claude/lessons.db (oder $LESSONS_DB_PATH). Eine Tabelle + FTS5-Index, die beim ersten Start automatisch erstellt wird.

Integration mit Claude Code

1. Zur MCP-Konfiguration hinzufügen

Fügen Sie dies zu ~/.claude/mcp.json hinzu:

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

2. Zeiger zu MEMORY.md hinzufügen

Fügen Sie dies zu ~/.claude/memory/MEMORY.md hinzu:

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

3. Claude Code neu starten

Der Server startet automatisch, wenn Claude Code gestartet wird. Sie sollten in den Protokollen sehen: lessons-mcp v1.0.0 | ~/.claude/lessons.db | 1 lessons