mcp-memories

Un servidor MCP que captura las sesiones de compilación de código y las publica en una base de conocimiento compartida del equipo, haciendo que el trabajo pasado sea descubrible mediante búsqueda semántica.

Qué hace:

• Captura automáticamente cada sesión de agente mediante hooks del IDE (Cursor, Claude Code)

• Cuando llamas a complete_session, lo resume con Grove AI y lo embeddings con Voyage voyage-code-4

• Los miembros del equipo buscan con lenguaje natural: la búsqueda vectorial + el reranking de Voyage devuelve las compilaciones pasadas más relevantes

Configuración

1. Instalar y compilar

npm install
npm run build

2. Configurar el entorno

cp .env.example .env
# Fill in MONGODB_URI, MDB_GROVE_API_KEY, GROVE_BASE_URL, VOYAGE_API_KEY, MEMORIES_AUTHOR

3. Registrar el servidor MCP

Añádelo a la configuración MCP de tu IDE (por ejemplo, ~/.cursor/mcp.json o config.json de Claude Desktop):

{
  "mcpServers": {
    "mcp-memories": {
      "command": "node",
      "args": ["/path/to/mcp-memories/dist/index.js"],
      "env": {
        "MONGODB_URI": "mongodb+srv://...",
        "MEMORIES_DB": "mcp_memories",
        "MDB_GROVE_API_KEY": "...",
        "GROVE_BASE_URL": "...",
        "GROVE_MODEL": "claude-3-7-sonnet",
        "VOYAGE_API_KEY": "...",
        "MEMORIES_AUTHOR": "your.name"
      }
    }
  }
}

4. Configurar los hooks de captura automática

Cursor — hooks.json ya está en .cursor/hooks.json. Ejecuta el script de captura automáticamente en cada evento stop.

Claude Code — fusiona el fragmento de hooks/claude/settings-snippet.json en tu ~/.claude/settings.json, actualizando la ruta para que apunte a este repositorio.

Related MCP server: Concept Tracker

Herramientas

Flujo de trabajo típico

# During a session — automatic (hook fires) or manual:
capture_activity(session_id="abc123", conversation_context="Built JWT auth middleware...")

# When done:
complete_session(session_id="abc123", final_notes="Ended up using RS256 instead of HS256 because...")

# Later, someone else starting similar work:
search_memories(query="JWT authentication middleware Node.js")

Configuración de MongoDB Atlas

El servidor crea sus propios índices al iniciarse, incluyendo el índice de Atlas Vector Search (memories_vector_index, 1024 dimensiones, similitud coseno, voyage-code-4). Necesitas un clúster de Atlas con Vector Search habilitado.