Administrador de memoria persistente de Zanny

Un servidor MCP (Proveedor de Capacidades de Modelo) personalizado que funciona como un banco de memoria persistente. Este servidor, basado en TypeScript, permite almacenar, recuperar y gestionar memorias con detección flexible de palabras clave y comandos.

Características

Almacenar recuerdos : guarde cualquier información basada en texto para recuperarla más tarde
Recuperar recuerdos : busca y recupera recuerdos almacenados por contenido o ID
Eliminar recuerdos : Elimina los recuerdos cuando ya no sean necesarios
Detección inteligente de palabras clave : detecta automáticamente comandos relevantes en lenguaje natural
Almacenamiento ilimitado : sin límites artificiales en el tamaño de almacenamiento de memoria
Registro completo : registro detallado para resolución de problemas y monitoreo
Compatibilidad con MCP : Implementación completa de JSON-RPC para la implementación de Smithery.ai

Instalación

Asegúrese de tener Node.js y npm instalados en su sistema
Instalar dependencias del proyecto:
npm install
Construya el proyecto TypeScript:
npm run build

Uso

Iniciando el servidor

Inicie el servidor con:

npm start

El servidor comenzará a escuchar en el puerto 3000 de forma predeterminada.

Puntos finales de API

API REST (heredada)

GET /health - Verificar el estado del servidor
POST /api/memories - Almacenar una nueva memoria
GET /api/memories - Listar o buscar memorias
GET /api/memories/:id - Recuperar una memoria específica
DELETE /api/memories/:id - Eliminar una memoria
POST /api/detect - Detecta palabras clave de activación en el texto

Puntos finales JSON-RPC (compatibles con MCP)

POST /tools/list - Lista de herramientas disponibles
POST /tools/call - Llamar a una herramienta específica

Comandos de memoria

El servidor MCP comprende comandos de lenguaje natural relacionados con la gestión de memoria. Ejemplos:

Almacenando recuerdos

remember: This is important information I want to store
store: The meeting is scheduled for March 15th at 2pm

Recuperando recuerdos

recall information about meetings
remember anything related to schedules

Borrando recuerdos

delete memory with id 5f4dcc3b5aa765d61d8327deb882cf99
forget id 5f4dcc3b5aa765d61d8327deb882cf99

Listado de todos los recuerdos

list all memories
show all memories

Estructura del proyecto

├── dist/                # Compiled JavaScript output
├── logs/                # Log files
├── src/                 # TypeScript source code
│   ├── config.ts        # Server configuration
│   ├── index.ts         # Entry point
│   ├── logger.ts        # Logging configuration
│   ├── mcpServer.ts     # Main MCP server implementation
│   └── memoryManager.ts # Memory storage and retrieval
├── package.json         # Project dependencies
├── smithery.json        # Smithery.ai configuration
├── tsconfig.json        # TypeScript configuration
└── README.md            # This file

Configuración

La configuración se gestiona en src/config.ts . Las opciones principales incluyen:

Nombre del servidor
Puerto del servidor
Directorio de recuerdos
Configuración del registrador
Palabras clave de activación

Implementación en Smithery.ai

Este servidor MCP es compatible con las implementaciones de Smithery.ai. Para implementar:

Asegúrese de que su código esté en un repositorio Git
Crea una cuenta de Smithery.ai si no tienes una
Conecte su repositorio a Smithery.ai
El archivo smithery.json incluido guiará el proceso de implementación

Explotación florestal

Los registros se almacenan en el directorio logs/ . Todos los registros tienen formato JSON para garantizar la compatibilidad con la especificación MCP.

Licencia

ISC

Zanny's Persistent Memory Manager

Integrations