Unsloth session memory MCP

A read-only MCP server that lets Unsloth Studio retrieve earlier local chat sessions from its SQLite database.

It exposes four tools:

• list_sessions

• get_session

• recall_previous_session

• search_sessions

Only user and assistant text is returned. System messages, tool output, reasoning blocks, images, audio, and attachments are excluded. Common API-key and token patterns are redacted from returned text.

Requirements

• ~/.unsloth/studio/studio.db에 히스토리가 있는 Unsloth Desktop 또는 Studio

• 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 빌드는 내부적으로 이 옵션을 제어할 수 있습니다.

명령으로 추가

Unsloth에서 로컬 MCP 서버를 생성하고 다음을 입력하세요:

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

Unsloth에 http://127.0.0.1:7331/mcp를 입력하거나 examples/unsloth-http-import.json을 가져오세요.

호스팅된 웹사이트 URL은 Mac의 Unsloth 데이터베이스를 읽을 수 없습니다. 데이터베이스를 의도적으로 다른 곳에 복사하거나 마운트하지 않는 한 이 서버를 Unsloth와 동일한 Mac에서 실행하세요.

다른 머신에서 접근하려면 TLS와 베어러 토큰을 사용하세요:

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 <your token>을 보내도록 구성하세요. 서버는 토큰 없이 비루프백 HTTP 바인딩을 거부합니다.

구성

examples/config.json을 복사하여 데이터베이스 경로, 응답 제한, 허용된 메시지 역할 또는 삭제 동작을 변경하세요.

환경 변수 재정의:

• UNSLOTH_MEMORY_CONFIG: 구성 파일 경로

• UNSLOTH_STUDIO_DB_PATH: 데이터베이스 경로 재정의

• UNSLOTH_MEMORY_TOKEN: HTTP 베어러 토큰

채팅 콘텐츠를 반환하지 않고 구성 확인:

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를 호출한 다음 선택한 스레드 ID로 get_session을 호출하세요.

Unsloth는 타사 MCP 서버에 현재 숨겨진 스레드 ID를 자동으로 제공하지 않습니다. 모델이 currentThreadId를 제공하지 않으면 recall_previous_session은 가장 최근에 저장된 스레드를 현재 채팅으로 간주하고 두 번째로 최근의 적격 스레드를 반환합니다. currentThreadId와 projectId를 제공하면 이 가정을 피할 수 있습니다.

개발 및 테스트

npm install
npm run check
npm run build
npm test

localhost 이외의 HTTP 전송을 노출하기 전에 SECURITY.md를 참조하세요.

라이선스

MIT