Unsloth session memory MCP

Сервер MCP только для чтения, который позволяет Unsloth Studio получать предыдущие локальные сеансы чата из своей базы данных SQLite.

Он предоставляет четыре инструмента:

• list_sessions

• get_session

• recall_previous_session

• search_sessions

Возвращается только текст пользователя и ассистента. Системные сообщения, вывод инструментов, блоки рассуждений, изображения, аудио и вложения исключаются. Общие шаблоны ключей API и токенов скрываются в возвращаемом тексте.

Требования

• Unsloth Desktop или Studio с историей в ~/.unsloth/studio/studio.db

• Node.js 22.5 или новее

Related MCP server: Claude Code History MCP Server

Добавление в Unsloth через конфигурационный файл

Скачайте examples/unsloth-npx-import.json, затем в Unsloth Studio:

1. Откройте чат и выберите MCP рядом с композитором.

2. Выберите Управление MCP-серверами.

3. Выберите Импорт конфигурации и выберите скачанный JSON-файл.

4. Включите Unsloth session memory и выберите Проверить соединение.

Конфигурация выполняет эту команду:

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

Если Unsloth сообщает, что локальные MCP-команды отключены, используйте опцию с локальным HTTP ниже. Сборки из исходного кода могут установить UNSLOTH_STUDIO_ALLOW_STDIO_MCP=1; готовые сборки Desktop могут управлять этой опцией внутренне.

Добавление в качестве команды

Создайте локальный MCP-сервер в Unsloth и введите:

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

Не требуется клонировать репозиторий. npx загружает публичный репозиторий GitHub и запускает stdio-сервер.

Добавление в качестве локального URL

Клонируйте репозиторий и запустите 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

Введите http://127.0.0.1:7331/mcp в Unsloth или импортируйте examples/unsloth-http-import.json.

URL размещенного веб-сайта не может прочитать базу данных Unsloth на вашем Mac. Запускайте этот сервер на том же Mac, что и Unsloth, если вы намеренно не копируете или не монтируете базу данных в другом месте.

Для доступа с другой машины используйте TLS и 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

Затем настройте MCP-клиент на отправку Authorization: Bearer <ваш токен>. Сервер отказывается от привязки HTTP к не-loopback адресу без токена.

Конфигурация

Скопируйте examples/config.json, чтобы изменить путь к базе данных, ограничения ответов, разрешенные роли сообщений или поведение скрытия.

Переопределения через переменные окружения:

• UNSLOTH_MEMORY_CONFIG: путь к конфигурационному файлу

• UNSLOTH_STUDIO_DB_PATH: переопределение пути к базе данных

• UNSLOTH_MEMORY_TOKEN: HTTP bearer-токен

Проверьте конфигурацию без возврата содержимого чата:

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

Процесс открывает SQLite в режиме только для чтения, а также включает PRAGMA query_only.

Использование в чате

Спросите Unsloth:

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

Для точного извлечения вызовите list_sessions, а затем get_session с выбранным идентификатором потока.

Unsloth не передает автоматически текущий скрытый идентификатор потока стороннему MCP-серверу. Если модель не предоставляет currentThreadId, recall_previous_session считает самый новый сохраненный поток текущим чатом и возвращает второй по новизне подходящий поток. Передача currentThreadId и projectId позволяет избежать этого предположения.

Разработка и тестирование

npm install
npm run check
npm run build
npm test

Перед тем как открыть HTTP-транспорт за пределами localhost, ознакомьтесь с SECURITY.md.

Лицензия

MIT