mcp-memoria

Memoria de proyectos compartida. MCP server gemelo de mop-mcp pero para conocimiento: decisiones, lecciones, ADRs, links entre proyectos/ideas.

Quick reference

• Endpoint target: http://secops:9092/mcp (HTTP, JSON-RPC sobre Streamable HTTP)
• Stack: Python 3.12 + FastAPI + uvicorn (replica mop-mcp v3.4.2)
• Privacidad: allowlist de paths (NO MEMORY/USER/SOUL/IDENTITY/AGENTS/briefing)
• HA: backup diario a geo + tars vps (2 destinos, sin OCI por ahora)
• Embeddings + vector store (decisión 2026-07-01 corregida: sistema de memoria de la organización, requiere calidad)
• Lifecycle: 1 año (compromiso de Rodrigo)
• Status: PLAN — discovery completo, listo para implementación

Docs en este directorio

• PLAN.md — plan completo: decisiones, stack, arquitectura, tools, tasks, riesgos, criterios de éxito
• SECURITY.md — privacy boundaries (qué lee y qué NO lee, test de no-leak)
• OPEN_QUESTIONS.md — 4 puntos pendientes antes de implementar

Tools que va a exponer (9)

• decision_list / decision_get — decisiones técnicas
• lesson_list / lesson_get — lecciones aprendidas
• adr_get — ADRs (Architecture Decision Records)
• project_brief — resumen por proyecto
• cross_links — entidades que mencionan un topic
• link_add / link_list — vincular entidades (append-only log)

Sources permitidos

• ~/.openclaw/workspace/kb/{decisions,lessons,jobs,concepts,wiki}/
• ~/.openclaw/workspace/04-decisions/
• ~/.openclaw/workspace/clientes/*/decisions.md

NO lee (denylist explícito): MEMORY.md, USER.md, SOUL.md, IDENTITY.md, AGENTS.md, briefing/, memory/sessions/, clientes//contactos

Cómo deployar (cuando se implemente)

cd /opt/mcps/memoria
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .
sudo systemctl mcp-memoria
curl http://secops:9092/health