zikra
OfficialZikra — командная память для ИИ-агентов
Это не просто память сессии. Это общий, управляемый уровень памяти для каждого агента, каждого человека и каждого проекта, над которым работает ваша команда.
Веб-сайт: zikra.dev · Self-hosted · MIT · Масштабируется до миллионов записей
zikra 17 runs · 847 memories │ you@team-server │ Sonnet 4.6 │ ~/project (main) │ 387K/200K ████░░░░░░ 45%Установка одной командой
claude mcp add zikra http://localhost:8000/mcp --header "Authorization: Bearer YOUR_TOKEN"Или добавьте в ~/.claude/settings.json:
{ "mcpServers": { "zikra": { "url": "http://localhost:8000/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }У вас еще нет сервера? → Шаг 1 ниже займет около 2 минут.
Большинство инструментов для ИИ-памяти решают одну задачу: один агент лучше запоминает одну сессию.
Zikra решает более сложную задачу: несколько человек, запускающих несколько ИИ-агентов в рамках нескольких проектов — все они используют общий пул памяти, где нужный человек привязан к нужному проекту, нужный агент извлекает нужный контекст, а миллионы воспоминаний остаются актуальными благодаря встроенной системе оценки гигиены данных.
Это не память сессии. Это общий мозг для команды, работающей с ИИ.
Что вы получаете | Что это значит |
Мультиагентность | Claude Code, Gemini CLI, Codex — один пул, один токен |
Многопользовательский режим | Роли владельца / администратора / разработчика / наблюдателя для каждого проекта |
Мультипроектность | Изолированные пространства имен; одна команда ведет |
Масштабируемость | Бэкенд на PostgreSQL — обрабатывает миллионы записей без перестроения индексов |
Гигиена памяти | Встроенный промпт гигиены: затухание уверенности, обнаружение сирот, очистка устаревших данных |
Структура | Не просто «сохранить текст» — решения, требования, промпты, ошибки, дневники сессий |
Автосохранение | Хуки Stop + PreCompact автоматически записывают каждую сессию |
— Mukarram
Related MCP server: mcp-memory-graph
Сравнение Zikra
Zikra | MCP Memory¹ | mem0 | basic-memory | MemoryMesh | |
Работает с несколькими ИИ-инструментами | ✅ | ❌ | ✅ платно | ❌ | ❌ |
Командный доступ с ролями пользователей | ✅ RBAC | ❌ | ✅ платно | ❌ | ❌ |
Пространства имен для нескольких проектов | ✅ | ❌ | ✅ платно | ❌ | ❌ |
Self-hosted, без зависимости от облака | ✅ | ✅ | ❌ | ✅ | ✅ |
Автосохранение через хуки сессий | ✅ | ❌ | ❌ | ❌ | ❌ |
Гибридный векторный + поиск по словам | ✅ | ❌ только граф | ✅ | ❌ | ❌ |
Затухание уверенности / гигиена памяти | ✅ встроенный промпт | ❌ | ❌ | ❌ | ❌ |
Именованные промпты + требования | ✅ | ❌ | ❌ | ❌ | ❌ |
Масштабируется до миллионов записей | ✅ Postgres | ❌ in-memory | ✅ облако | ❌ | ❌ |
Лицензия | MIT | MIT | Проприетарная | MIT | MIT |
¹ @modelcontextprotocol/server-memory — официальный эталонный сервер от Anthropic.
Начало работы
Шаг 1 — Установка сервера
git clone https://github.com/getzikra/zikra
cd zikra
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .
python3 installer.py # interactive setup, ~2 minutes
python3 -m zikraУстановщик создает файл .env и генерирует ваш токен администратора. По умолчанию сервер привязывается к http://localhost:8000.
Чтобы получить доступ с других машин, запустите
cloudflared tunnel --url http://localhost:8000(бесплатно, дает постоянный публичный URL, напримерhttps://zikra.yourteam.com).
Шаг 2 — Включение MCP в Claude Code
Откройте Claude Code → Settings → MCP → Add Server и вставьте:
{
"mcpServers": {
"zikra": {
"url": "http://your-server:8000/mcp",
"headers": { "Authorization": "Bearer YOUR_ZIKRA_TOKEN" }
}
}
}Установщик делает это автоматически при локальном запуске.
Шаг 3 — Подключение вашего ИИ-агента для кодинга
Вставьте промпт для вашего агента в сессию. Он обрабатывает как первую установку, так и обновления.
Claude Code:
Fetch https://raw.githubusercontent.com/GetZikra/zikra/main/prompts/zikra-claude-code-setup.md
and follow every instruction in it.Это устанавливает хук Stop (автосохранение каждой сессии), хук PreCompact и живую строку состояния, отображающую количество запусков и статистику памяти.
Обновление Zikra
Сервер:
cd ~/zikra && ./update.shХуки Claude Code — перезапустите промпт онбординга. Он обнаружит существующую установку и обновит только то, что изменилось.
Профили
Профиль | Хранилище | Хуки | Доп. зависимости |
Webhook (по умолчанию) | SQLite ¹ | нет | нет |
Auto-log | SQLite ¹ | хуки сессий | нет |
Full | SQLite ¹ или Postgres | хуки + демон | asyncpg (только Postgres) |
¹ SQLite предназначен только для локального использования / одного пользователя. Для развертывания в команде установите DB_BACKEND=postgres.
Переменные окружения
Переменная | Обязательно | По умолчанию | Описание |
| Да | сгенерировано | Bearer-токен для API |
| Нет | — | Включает семантический поиск. Если отсутствует — только поиск по словам. |
| Нет |
|
|
| Только Postgres |
| |
| Только Postgres |
| |
| Только Postgres | — | |
| Только Postgres | — | |
| Только Postgres | — | |
| Нет |
| Адрес привязки |
| Нет |
| HTTP-порт |
| Нет |
| Путь к базе данных SQLite |
| Нет |
| Проект по умолчанию |
| Нет |
| Замените на локальный или совместимый эндпоинт эмбеддингов |
| Нет |
| Имя модели эмбеддингов |
| Нет |
| Период полураспада памяти в днях |
| Нет |
| Вес коэффициента частоты доступа |
Как ранжируются результаты
Каждый результат поиска проходит через систему оценки:
Возраст — недавние воспоминания имеют более высокий приоритет. Период полураспада: 30 дней. Минимум: 0.05.
Частота доступа — часто используемые промпты поднимаются выше (логарифмическая шкала).
Уверенность — воспоминания, сохраненные с низким
confidence_score, ранжируются ниже.
Справочник команд
Все команды выполняются через POST /webhook/zikra с заголовком Authorization: Bearer <token>.
Команда | Алиасы | Описание |
|
| Гибридный семантический поиск + поиск по словам |
|
| Сохранить воспоминание с эмбеддингом |
|
| Получить по заголовку или |
|
| Получить именованный промпт |
|
| Залогировать завершенный запуск агента |
|
| Залогировать ошибку |
| — | Сохранить требование проекта |
|
| Сохранить промпт с эмбеддингом |
|
| Список промптов для проекта |
|
| Список требований |
|
| Изменить тип требования |
|
| Сгенерировать bearer-токен (роль владельца) |
|
| Интроспекция DDL базы данных |
|
| Полный справочник команд |
| — | Диагностика бэкенда |
Роли: owner · admin · developer · viewer
Бэкенд PostgreSQL
DB_BACKEND=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ai_zikra
DB_USER=postgres
DB_PASSWORD=yourpasswordpip install -e ".[postgres]"Лицензия
MIT — см. LICENSE
Проектируйте в Claude Web. Выполняйте в Claude Code. Делитесь со всей командой. Claude Web · Claude Code · Gemini CLI · Codex · любой агент, поддерживающий POST.
This server cannot be deployed
Maintenance
Related MCP Connectors
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
- mcpOAuthai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Related MCP Servers
AlicenseAqualityBmaintenanceSelf-hosted MCP-native agent memory server. Gives AI agents persistent, decay-weighted memory via 83 MCP tools — no cloud, full control. RocksDB+HNSW backend. Works with Claude Code, Cursor, and any MCP-compatible agent.148MIT- AlicenseAqualityCmaintenanceLocal-first memory for Claude Code and any MCP client: hybrid vector + keyword search and a bi-temporal knowledge graph in one SQLite file. Local embeddings, no API key, $0/token.51108 npm2PolyForm Noncommercial 1.0.0
- FlicenseNot gradedqualityDmaintenancePersistent memory server for AI assistants with semantic search and three-layer context (global, project, personality). Works with MCP-compatible AI tools like Claude Code, Cursor, Continue, Cline, and more.1-
- AlicenseNot gradedqualityCmaintenanceA persistent memory MCP server for Claude Code that enables long-term recall across sessions via hybrid search, code intelligence, and tools for reading/writing memory.9 npm5MIT