Memoria MCP

Un servidor de protocolo de contexto de modelo para almacenar y recuperar memorias utilizando una implementación de servidor de bajo nivel y almacenamiento SQLite.

Instalación

Este proyecto utiliza uv para la gestión de dependencias en lugar de pip. uv es un instalador y solucionador de paquetes de Python rápido y confiable.

Instalar usando uv:

uv pip install memory-mcp

O instalar directamente desde la fuente:

uv pip install .

Para desarrollo:

uv pip install -e ".[dev]"

Si no tienes instalado uv, puedes instalarlo siguiendo las instrucciones oficiales .

Uso

Ejecutando el servidor

memory-mcp

Esto iniciará el servidor MCP que le permite almacenar y recuperar memorias.

Herramientas disponibles

El Memory MCP proporciona las siguientes herramientas:

remember : Almacena un nuevo recuerdo con un título y contenido
get_memory : recupera una memoria específica por ID o título
list_memories : Lista todas las memorias almacenadas
update_memory : Actualizar una memoria existente
delete_memory : Borrar una memoria

Depuración con MCP Inspect

MCP proporciona una práctica herramienta de línea de comandos llamada mcp inspect que le permite depurar e interactuar con su servidor MCP directamente.

Configuración

Primero, asegúrese de que las herramientas CLI de MCP estén instaladas:

uv pip install mcp[cli]

Inicie el servidor Memory MCP en una terminal:

memory-mcp

En otra terminal, conéctese al servidor en ejecución usando mcp inspect :

mcp inspect

Uso de MCP Inspect

Una vez conectado, podrás:

Lista de herramientas disponibles

> tools

Esto mostrará todas las herramientas proporcionadas por el servidor Memory MCP.

Llamar a una herramienta

Para llamar a una herramienta, utilice el comando call seguido del nombre de la herramienta y los argumentos requeridos:

> call remember title="Meeting Notes" content="Discussed project timeline and milestones."

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="Updated Title" content="Updated content."

> call delete_memory memory_id=1

Modo de depuración

Puede habilitar el modo de depuración para ver información detallada de solicitudes y respuestas:

> debug on

Esto le ayudará a comprender exactamente qué datos se envían al servidor y se reciben del mismo.

Explorando esquemas de herramientas

Para ver el esquema de una herramienta específica:

> tool remember

Aquí se muestra el esquema de entrada, los parámetros requeridos y la descripción de la herramienta.

Solución de problemas

Si encuentra problemas:

Verifique los registros del servidor en la terminal donde se ejecuta su servidor para detectar cualquier mensaje de error.
En la terminal de inspección de MCP, habilite el modo de depuración con debug on para ver las solicitudes y respuestas sin procesar.
Asegúrese de que los parámetros de la herramienta coincidan con el esquema esperado (verifique con el comando tool ).
Si el servidor falla, verifique si hay excepciones no detectadas en la terminal del servidor.

Desarrollo

Para contribuir al proyecto, instale las dependencias de desarrollo:

uv pip install -e ".[dev]"

Gestión de dependencias

Este proyecto utiliza el archivo uv.lock para bloquear las dependencias. Para actualizar las dependencias:

uv pip compile pyproject.toml -o uv.lock

Ejecución de pruebas

python -m pytest

Formato de código

black memory_mcp tests

Pelusa

ruff check memory_mcp tests

Comprobación de tipos

mypy memory_mcp