whimsicality-mcp

Сервер MCP (Model Context Protocol), который даёт 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: "..."})

Бэкенды

Сервер поддерживает четыре способа найти ядро, которые пробуются по порядку:

1. Дисковый запасной вариант (по умолчанию, нулевая настройка)

Работает из коробки. Данные сохраняются в JSON-файл по пути ~/.whimsicality/kernel-storage/whim-mcp-store.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 workspace и соберите:

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