lessons-mcp

Un servidor MCP para Claude Code que almacena y busca lecciones aprendidas, para que Claude no repita errores del pasado. Piénsalo como un registro de experiencia persistente con búsqueda de texto completo y navegación basada en etiquetas.

Inicio rápido

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

Añadir a ~/.claude/mcp.json:

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

Herramientas

suggest_metadata

Previsualiza categorías/etiquetas disponibles antes de escribir. Devuelve el panorama existente + sugerencia.

record_lesson

Registra una nueva lección. Devuelve comentarios sobre la consistencia en la reutilización de etiquetas.

search_lessons

Busca lecciones pasadas. FTS5 (etiquetas/categoría/título) + alternativa LIKE (cuerpo en chino).

list_categories

Explora categorías con actividad reciente de etiquetas.

list_tags

Explora etiquetas dentro de una categoría con recuento de uso.

Almacenamiento

SQLite en ~/.claude/lessons.db (o $LESSONS_DB_PATH). Una tabla + índice FTS5, creado automáticamente en la primera ejecución.

Integración con Claude Code

1. Añadir a la configuración de MCP

Añadir a ~/.claude/mcp.json:

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

2. Añadir puntero a MEMORY.md

Añadir a ~/.claude/memory/MEMORY.md:

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

3. Reiniciar Claude Code

El servidor se inicia automáticamente cuando se lanza Claude Code. Deberías ver en los registros: lessons-mcp v1.0.0 | ~/.claude/lessons.db | 1 lessons