Saltar al contenido principal

Setup del servidor MCP

Model Context Protocol (MCP) es un standard open que permite a un host (un IDE, un runtime de agente, un cliente desktop) descubrir y llamar tools expuestas por un server sobre stdio o HTTP. iLAB Memory ofrece un servidor MCP stdio que expone los 8 métodos de la fachada como tools MCP — con docstrings completos — así el agente las puede usar correctamente sin que tengas que hacer prompt engineering adicional.

Levantar el server​

Después de instalar el package, tenés disponible el entrypoint ilab-memory mcp:

pip install ilab-memory
ilab-memory mcp --db-path ~/.ilab-memory/memory.db

El proceso habla MCP por stdio. No lo corrés directamente — lo registrás como server en el config de tu host MCP, y el host lo spawnea cuando lo necesita.

Claude Code​

Claude Code lee servers MCP desde un .mcp.json local del proyecto o del ~/.claude/settings.json global del user.

Local del proyecto — .mcp.json en la raíz del repo​

{
  "mcpServers": {
    "ilab-memory": {
      "command": "ilab-memory",
      "args": ["mcp", "--db-path", "./.ilab-memory/memory.db"]
    }
  }
}

Global del user — ~/.claude/settings.json​

{
  "mcpServers": {
    "ilab-memory": {
      "command": "ilab-memory",
      "args": ["mcp", "--db-path", "~/.ilab-memory/memory.db"]
    }
  }
}

Reiniciá Claude Code; las 8 tools (mem_session_start, mem_save, mem_search, mem_get_observation, mem_timeline, mem_session_summary, mem_session_end, mem_stats) aparecen en la tool list del agente al toque.

Claude Desktop​

Editá claude_desktop_config.json (la ubicación varía por OS — ver los docs de Claude Desktop):

{
  "mcpServers": {
    "ilab-memory": {
      "command": "ilab-memory",
      "args": ["mcp", "--db-path", "/Users/<vos>/Library/Application Support/ilab-memory/memory.db"]
    }
  }
}

Reiniciá Claude Desktop. Las tools quedan callables desde cualquier chat.

Cursor​

Cursor soporta servers MCP vía su UI de settings (Settings → Features → MCP). Registrá un server nuevo con:

  • Command: ilab-memory
  • Args: mcp --db-path /path/absoluto/a/memory.db

Cursor maneja el resto.

Las tools vienen pre-descritas​

nota

El docstring de cada tool (firma, parámetros, reglas de cuándo llamar, error codes) se le surfacea al agente en tools/list. Los docstrings viven en package/src/ilab_memory/api/mcp.py y son deliberadamente verbosos — el agente no debería necesitar un CLAUDE.md externo para usarlos correctamente.

Para el texto canónico que recibe el agente, leé api/mcp.py directo o llamá tools/list contra un server corriendo.

Validar la conexión​

Una forma rápida de confirmar que el server está bien cableado:

  1. Empezá un chat fresco en tu host MCP.
  2. Pedile al agente: "Llamá mem_session_start para user_id='alice'."
  3. El agente debería devolver un JSON SessionStartResponse — session_id, is_new=true, memories[] vacío en una base limpia.

Si la tool no aparece en la lista, revisá el par command/args y que ilab-memory esté en el PATH del proceso del host.

Ver también​

Recetario: Agente de larga duración

Referencia de librería