Memoria de sesiones de Unsloth MCP

Un servidor MCP de solo lectura que permite a Unsloth Studio recuperar sesiones de chat locales anteriores desde su base de datos SQLite.

Expone cuatro herramientas:

• list_sessions

• get_session

• recall_previous_session

• search_sessions

Solo se devuelve el texto de usuario y asistente. Se excluyen mensajes del sistema, salida de herramientas, bloques de razonamiento, imágenes, audio y archivos adjuntos. Los patrones comunes de clave API y token se redactan del texto devuelto.

Requisitos

• Unsloth Desktop o Studio con historial en ~/.unsloth/studio/studio.db

• Node.js 22.5 o superior

Related MCP server: Claude Code History MCP Server

Añadirlo a Unsloth con un archivo de configuración

Descargue examples/unsloth-npx-import.json, luego en Unsloth Studio:

1. Abra un chat y seleccione MCP junto al compositor.

2. Seleccione Gestionar servidores MCP.

3. Seleccione Importar configuración y elija el archivo JSON descargado.

4. Active Memoria de sesiones de Unsloth y seleccione Probar conexión.

La configuración ejecuta este comando:

npx --yes github:kashyaparun25/unsloth-session-memory-mcp --stdio

Si Unsloth informa que los comandos MCP locales están deshabilitados, use la opción HTTP local a continuación. Las compilaciones desde el código fuente pueden establecer UNSLOTH_STUDIO_ALLOW_STDIO_MCP=1; las compilaciones empaquetadas de Desktop pueden controlar esta opción internamente.

Añadirlo como comando

Cree un servidor MCP local en Unsloth e introduzca:

npx --yes github:kashyaparun25/unsloth-session-memory-mcp --stdio

No se requiere clonación del repositorio. npx descarga el repositorio público de GitHub e inicia el servidor stdio.

Añadirlo como URL local

Clone el repositorio e inicie el transporte HTTP:

git clone https://github.com/kashyaparun25/unsloth-session-memory-mcp.git
cd unsloth-session-memory-mcp
npm install
npm run build
node dist/cli.js --http --config examples/config.json

Introduzca http://127.0.0.1:7331/mcp en Unsloth, o importe examples/unsloth-http-import.json.

Una URL de sitio web alojado no puede leer la base de datos de Unsloth en su Mac. Ejecute este servidor en el mismo Mac que Unsloth a menos que deliberadamente copie o monte la base de datos en otro lugar.

Para acceso desde otra máquina, use TLS y un token bearer:

UNSLOTH_MEMORY_TOKEN='replace-with-a-random-value' \
node dist/cli.js --http --host 0.0.0.0 --port 7331 --config examples/config.json

Luego configure el cliente MCP para enviar Authorization: Bearer <su token>. El servidor rechaza un enlace HTTP no loopback sin un token.

Configuración

Copie examples/config.json para cambiar la ruta de la base de datos, límites de respuesta, roles de mensaje permitidos o comportamiento de redacción.

Anulaciones de entorno:

• UNSLOTH_MEMORY_CONFIG: ruta del archivo de configuración

• UNSLOTH_STUDIO_DB_PATH: anulación de la ruta de la base de datos

• UNSLOTH_MEMORY_TOKEN: token bearer HTTP

Verifique la configuración sin devolver contenido de chat:

npx --yes github:kashyaparun25/unsloth-session-memory-mcp --check

El proceso abre SQLite en modo solo lectura y también habilita PRAGMA query_only.

Usarlo en un chat

Pregunte a Unsloth:

Use recall_previous_session to retrieve the previous chat, then tell me what we decided.

Para una recuperación precisa, llame a list_sessions y luego a get_session con el ID de hilo seleccionado.

Unsloth no proporciona automáticamente el ID de hilo oculto actual a un servidor MCP de terceros. Si el modelo no proporciona currentThreadId, recall_previous_session trata el hilo almacenado más reciente como el chat actual y devuelve el segundo hilo elegible más reciente. Proporcionar currentThreadId y projectId evita esa suposición.

Desarrollar y probar

npm install
npm run check
npm run build
npm test

Consulte SECURITY.md antes de exponer el transporte HTTP más allá de localhost.

Licencia

MIT