Skip to main content
Glama
getzikra
by getzikra

Zikra — командная память для ИИ-агентов

Это не просто память сессии. Это общий, управляемый уровень памяти для каждого агента, каждого человека и каждого проекта, над которым работает ваша команда.

License: MIT MCP

Веб-сайт: 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 — один пул, один токен

Многопользовательский режим

Роли владельца / администратора / разработчика / наблюдателя для каждого проекта

Мультипроектность

Изолированные пространства имен; одна команда ведет veltisai, design, global

Масштабируемость

Бэкенд на 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.


Переменные окружения

Переменная

Обязательно

По умолчанию

Описание

ZIKRA_TOKEN

Да

сгенерировано

Bearer-токен для API

OPENAI_API_KEY

Нет

—

Включает семантический поиск. Если отсутствует — только поиск по словам.

DB_BACKEND

Нет

sqlite

sqlite или postgres

DB_HOST

Только Postgres

localhost

DB_PORT

Только Postgres

5432

DB_NAME

Только Postgres

—

DB_USER

Только Postgres

—

DB_PASSWORD

Только Postgres

—

ZIKRA_HOST

Нет

0.0.0.0

Адрес привязки

ZIKRA_PORT

Нет

8000

HTTP-порт

ZIKRA_DB_PATH

Нет

./zikra.db

Путь к базе данных SQLite

ZIKRA_PROJECT

Нет

main

Проект по умолчанию

OPENAI_API_BASE

Нет

https://api.openai.com/v1

Замените на локальный или совместимый эндпоинт эмбеддингов

ZIKRA_EMBEDDING_MODEL

Нет

text-embedding-3-small

Имя модели эмбеддингов

ZIKRA_DECAY_DAYS

Нет

30

Период полураспада памяти в днях

ZIKRA_FREQUENCY_WEIGHT

Нет

0.1

Вес коэффициента частоты доступа


Как ранжируются результаты

Каждый результат поиска проходит через систему оценки:

  • Возраст — недавние воспоминания имеют более высокий приоритет. Период полураспада: 30 дней. Минимум: 0.05.

  • Частота доступа — часто используемые промпты поднимаются выше (логарифмическая шкала).

  • Уверенность — воспоминания, сохраненные с низким confidence_score, ранжируются ниже.


Справочник команд

Все команды выполняются через POST /webhook/zikra с заголовком Authorization: Bearer <token>.

Команда

Алиасы

Описание

search

find, query, recall

Гибридный семантический поиск + поиск по словам

save_memory

save, store

Сохранить воспоминание с эмбеддингом

get_memory

fetch_memory

Получить по заголовку или id

get_prompt

fetch_prompt

Получить именованный промпт

log_run

log_session

Залогировать завершенный запуск агента

log_error

log_bug

Залогировать ошибку

save_requirement

—

Сохранить требование проекта

save_prompt

write_prompt

Сохранить промпт с эмбеддингом

list_prompts

get_prompts

Список промптов для проекта

list_requirements

list_reqs

Список требований

promote_requirement

promote

Изменить тип требования

create_token

new_token

Сгенерировать bearer-токен (роль владельца)

get_schema

schema

Интроспекция DDL базы данных

zikra_help

help

Полный справочник команд

debug_protocol

—

Диагностика бэкенда

Роли: owner · admin · developer · viewer


Бэкенд PostgreSQL

DB_BACKEND=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ai_zikra
DB_USER=postgres
DB_PASSWORD=yourpassword
pip install -e ".[postgres]"

Лицензия

MIT — см. LICENSE

Проектируйте в Claude Web. Выполняйте в Claude Code. Делитесь со всей командой. Claude Web · Claude Code · Gemini CLI · Codex · любой агент, поддерживающий POST.

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Self-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.
    14
    8
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Persistent 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
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    A 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 npm
    5
    MIT