一个 MCP（模型上下文协议） 服务器，为 AI 代理提供持久化记忆——跨会话和进程存活的上下文存储、事实、计划、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: "..."})服务器支持四种查找内核的方式，按顺序尝试：
开箱即用。数据持久化到 ~/.whimsicality/kernel-storage/whim-mcp-store.json 的 JSON 文件中。RAG/片段的词重叠搜索。无需原生依赖。
npm install @whimsicalitylabs/kernel-prebuilt通过 npm optionalDependencies 分发的平台特定预构建二进制文件。服务器会自动发现 node_modules 中的二进制文件。
注意： 预构建二进制文件尚不适用于所有平台。请参阅 kernel-prebuilt 了解状态。
{
"mcpServers": {
"whimsicality": {
"command": "npx",
"args": ["whimsicality-mcp"],
"env": {
"WHIMSICALITY_KERNEL_BIN": "/path/to/whimsicality-kernel"
}
}
}
}克隆 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 中，进程退出时会丢失）。
所有配置均通过环境变量进行：
变量 | 默认值 | 描述 |
|
| 所有存储数据的根目录 |
| （自动发现） | Rust 内核二进制文件的路径 |
|
| 热层 RAM 预算（MB）（仅内核） |
git clone https://github.com/WhimsicalityLabs/Whimsicality-MCP.git
cd whimsicality-mcp
npm install
npm run build
node bin/whimsicality-mcp.jsMIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Persistent memory for AI agents. Search, store, and recall across sessions.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/WhimsicalityLabs/Whimsicality-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server