whimsicality-mcp

AIエージェントに永続メモリを提供するMCP（Model Context Protocol）サーバーです。コンテキスト保存、ファクト、プラン、RAG検索、コードスニペット、会話の圧縮がセッションやプロセスをまたいで保持されます。

MCP互換のエージェントならどれでも動作します：Devin CLI、Claude Desktop、Cursorなど。

クイックスタート

# Install globally
npm install -g whimsicality-mcp

# Or run without installing
npx whimsicality-mcp

次に、エージェントのMCP設定に追加します：

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"]
    }
  }
}

これだけです。サーバーはディスクベースの永続化でそのまま動作し、ネイティブ依存関係は不要です。データは~/.whimsicality/kernel-storage/に保存されます。

Related MCP server: Memory MCP

ツール

サーバーは14個のツールを公開しており、すべてwhim_プレフィックスが付いています：

エージェントの使用方法

セッション開始時 — 以前のエージェントから状態を復元：

1. whim_plan_get({})              → read the current plan
2. whim_facts_list({})            → list all facts
3. whim_facts_get({name: "..."})  → read relevant facts
4. whim_context_list({})          → list all context slots
5. whim_context_get({key: "..."}) → read relevant slots

作業中 — 次のエージェントのために状態を保存：

whim_plan_save({plan: "updated plan with progress and next steps"})
whim_facts_save({name: "new_fact", value: "..."})
whim_context_set({key: "what_i_learned", text: "..."})

バックエンド

サーバーはカーネルを見つける4つの方法をサポートしており、順に試行されます：

1. ディスクフォールバック（デフォルト、セットアップ不要）

そのまま動作します。データは~/.whimsicality/kernel-storage/whim-mcp-store.jsonのJSONファイルに永続化されます。RAG/スニペットは単語オーバーラップ検索を使用します。ネイティブ依存関係はありません。

2. プリビルドカーネルバイナリ（最も簡単なアップグレード）

npm install @whimsicalitylabs/kernel-prebuilt

プラットフォーム固有のプリビルドバイナリは、npmのoptionalDependenciesを介して配布されます。サーバーはnode_modules内のバイナリを自動検出します。

注： プリビルドバイナリはまだすべてのプラットフォームで利用できるわけではありません。ステータスについてはkernel-prebuiltを参照してください。

3. 既存のバイナリを指定

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"],
      "env": {
        "WHIMSICALITY_KERNEL_BIN": "/path/to/whimsicality-kernel"
      }
    }
  }
}

4. ソースからビルド

Rustワークスペースをクローンしてビルド：

git clone https://github.com/WhimsicalityLabs/whimsicality-kernel.git
cd whimsicality-kernel
cargo build --release

次に、WHIMSICALITY_KERNEL_BINをtarget/release/whimsicality-kernelに設定します。

カーネルが追加するもの

Rustカーネルは以下を提供します：

• 階層型ストレージ：ホット（RAM）→ ウォーム（mmap）→ コールド（ディスク上のzstd）で、自動プロモーション/デモーション付き

• コンテンツアドレス型の重複排除：同一の値はblake3ハッシュを介してストレージを共有

• ロックフリーのホットパス：並行読み取り用のDashMap

• 追記専用セッションログ：ブランチ/フォーク対応のbincodeエントリ

• 構造化コンテキストの組み立て：フラットなトークンストリームではなく、名前付き変数

カーネルが利用可能な場合、サーバーはカーネルとディスクの両方にデュアルライトします。これにより、カーネルの高速なセッション内アクセスと、セッション間の信頼性のためのディスク永続化の両方が得られます（カーネルのホットティアはRAMのみで、プロセス終了時に失われます）。

設定

すべての設定は環境変数を介して行います：

開発

git clone https://github.com/WhimsicalityLabs/Whimsicality-MCP.git
cd whimsicality-mcp
npm install
npm run build
node bin/whimsicality-mcp.js

ライセンス

MIT