Unsloth セッションメモリ MCP

Unsloth Studio が SQLite データベースから以前のローカルチャットセッションを取得できる、読み取り専用の MCP サーバーです。

以下の4つのツールを提供します：

• list_sessions

• get_session

• recall_previous_session

• search_sessions

ユーザーとアシスタントのテキストのみが返されます。システムメッセージ、ツール出力、推論ブロック、画像、音声、添付ファイルは除外されます。一般的な API キーやトークンパターンは、返されるテキストから編集されます。

必要条件

• 履歴が ~/.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 は最新の保存スレッドを現在のチャットとみなし、2番目に新しい該当スレッドを返します。currentThreadId と projectId を指定すると、その仮定を回避できます。

開発とテスト

npm install
npm run check
npm run build
npm test

HTTP トランスポートを localhost 以外に公開する前に、SECURITY.md を参照してください。

ライセンス

MIT