Memorix (MCP server) — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Кросс-агентный: работает с Claude Code, Cursor, Codex, Windsurf, Gemini CLI, OpenCode, Antigravity, Trae
Append-only с историей ревизий
Тегированное извлечение (project, language, decision)
Локальный SQLite-бэкенд; опциональная облачная синхронизация
Компактный — единый Node-бинарник
MIT

Живое демо

Как выглядит на практике

memorix-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add memorix-mcp -- npx -y memorix

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Memorix

Разделить соглашения проекта между всеми coding-агентами без переписывания

👤 Разработчики, работающие с несколькими AI-инструментами для кода ⏱ ~15 min beginner

Когда использовать: В первый день вы объясняете структуру монорепо Cursor, Claude Code и Codex — и потом забываете, кто что знает.

Предварительные требования

Memorix запущен — npx memorix — по умолчанию использует ~/.memorix.db

Поток

Занести воспоминания

Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ Скопировано

→ 5 воспоминаний добавлено с тегами
Воспроизвести в другом агенте

(в Cursor с тем же Memorix) — What conventions are set for this project?✓ Скопировано

→ Возвращает те же 5 воспоминаний
Обновить одно

Update memory: now using node 24 (was 22). Keep history.✓ Скопировано

→ Обновлено; история сохранена как ревизия

Итог: Контекст проекта сохраняется между агентами и между сессиями.

Подводные камни

Воспоминания устаревают — Используйте decay, чтобы помечать старые воспоминания низкой уверенностью; агенты учитывают это при взвешивании

Фиксировать архитектурные решения как запрашиваемые воспоминания

👤 Tech leads, staff-инженеры ⏱ ~20 min intermediate

Когда использовать: Вы принимаете решение («мы не используем Redux, только zustand») и хотите, чтобы оно закрепилось.

Поток

Зафиксировать решение

Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ Скопировано

→ Решение сохранено с тегом
Проверить соблюдение

Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ Скопировано

→ Последующие импорты помечаются с сохранённым обоснованием

Итог: Облегчённый ADR-журнал, который агенты реально читают.

Подводные камни

Memorix привязан к пользователю; командные ADR нужна облачная синхронизация или зафиксированное зеркало — Используйте --export ./adr.json и зафиксируйте в git; коллеги делают --import для синхронизации

Сочетать с: github

Передать сессию отладки другому агенту

👤 Разработчики, переключающиеся между моделями в середине задачи ⏱ ~10 min intermediate

Когда использовать: Claude отлаживал 2 часа, и вы хотите переключиться на Codex, не пересказывая всё заново.

Поток

Снимок

Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ Скопировано

→ Снимок сохранён с тегом debug-session-<id>
Продолжить в другом месте

(в Codex) — Load debug session and continue from where Claude left off.✓ Скопировано

→ Codex суммирует снимок и предлагает следующий шаг

Итог: Безболезненная смена агента в середине задачи.

Подводные камни

Снимок слишком расплывчатый; новый агент начинает с нуля — Инструмент snapshot в Memorix запрашивает: гипотезу, доказательства, следующий шаг — заполните все три

Комбинации

Сочетайте с другими MCP — эффект x10

memorix-mcp + github

Зеркалировать воспоминания в зафиксированный adr.json для командного обмена

memorix-mcp + filesystem

Резервное копирование локальной БД Memorix

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
save	content: str, tags: str[]	Сохранить факт / решение / снимок	бесплатно
recall	query?, tags?, limit?	Внести релевантный контекст в текущую задачу	бесплатно
update	id, content	Исправить или уточнить существующее воспоминание	бесплатно
decay	older_than_days	Периодическая очистка	бесплатно

Стоимость и лимиты

Во что обходится

Квота API: Локальный SQLite — ограничен диском
Токенов на вызов: 100–500 на recall
Деньги: Бесплатно; облачная синхронизация (при использовании) варьируется
Совет: Запускайте decay еженедельно, чтобы recall возвращал актуальный контекст, а не шестимесячные заметки по отладке

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Локальный SQLite по умолчанию; облачная синхронизация требует API-ключ

Исходящий трафик: Только локально по умолчанию

Воспоминания могут содержать секреты (например, «мы используем API-ключ XYZ») — проверяйте перед экспортом / коммитом

Устранение неполадок

Частые ошибки и исправления

Recall не возвращает релевантное

Проверьте теги — Memorix использует фильтрацию по тегам И нечёткий текстовый поиск

Проверить: Запустите без фильтра, чтобы увидеть все воспоминания

Ошибка блокировки БД

Несколько агентов пишут одновременно — Memorix использует WAL; убедитесь, что версия >= 0.4

Импорт завершается с ошибкой

Несовместимая схема между версией экспорта и импорта — обновите обе стороны

Альтернативы

Memorix в сравнении

Альтернатива	Когда использовать	Компромисс
doobidoo/mcp-memory-service	Вам нужны более богатые возможности, такие как граф знаний и консолидация	Тяжелее; Memorix намеренно минималистичен
OpenAI Memory / Anthropic Memory	Вы используете только одного провайдера	Привязан к этому провайдеру; Memorix кросс-агентный

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills