lessons-mcp

MCP-сервер для Claude Code, который хранит и позволяет искать извлеченные уроки, чтобы 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

Просмотр тегов внутри категории с количеством их использования.

Хранилище

SQLite в ~/.claude/lessons.db (или $LESSONS_DB_PATH). Одна таблица + индекс 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