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

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

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

Пять инструментов: Memory_bank_read, Memory_bank_write, Memory_bank_update, list_projects, list_project_files
Изоляция нескольких проектов — каждый проект имеет собственную папку в MEMORY_BANK_ROOT.
Встроенная функция предотвращения обхода пути — ограничена корнем, который вы настроили.
Типобезопасные операции с явными сообщениями об ошибках
Работает с любым клиентом MCP; нет зависимости от Клайна

Живое демо

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

memory-bank-mcp.replay ▶ готово

0/0

Установка

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

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

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memory-bank-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

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

claude mcp add memory-bank-mcp -- npx -y @allpepper/memory-bank-mcp

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

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

Реальные сценарии: Memory Bank MCP

Используйте один банк памяти для Claude Desktop, Cursor и Windsurf.

👤 Разработчики, которые переключаются между IDE и хотят иметь единый источник знаний о проекте. ⏱ ~15 min beginner

Когда использовать: Вы используете более одного AI-клиента и продолжаете копировать одни и те же заметки о проекте.

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

Узел 18+ — установка нвм 18
Каталог для хранения банков памяти — mkdir -p ~/ai-память

Поток

Установите MEMORY_BANK_ROOT в конфигурации MCP каждого клиента.

Укажите каждому клиенту MCP MEMORY_BANK_ROOT=~/ai-memory и установите @allpepper/memory-bank-mcp.✓ Скопировано

→ инструменты Memory_bank_* появляются в каждом клиенте
Создать первый банк проектов

Memory_bank_write project=acme-api file=architecture.md — суммируйте границы обслуживания этого репозитория.✓ Скопировано

→ Файл появится в папке ~/ai-memory/acme-api/architecture.md.
Чтение от другого клиента

В курсоре: Memory_bank_read project=acme-api file=architecture.md✓ Скопировано

→ Возвращен тот же контент; изменения из любого клиента отображаются мгновенно

Итог: Общая папка памяти с поддержкой версий, к которой каждая IDE обращается автоматически.

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

Забыть перезапустить клиент MCP после изменения MEMORY_BANK_ROOT — Закройте и снова откройте клиент; переменные env читаются только при запуске

Сочетать с: filesystem · github

Дайте новому агенту мгновенный контекст долгосрочного проекта.

👤 Команды, использующие несколько агентов в одной базе кода ⏱ ~10 min beginner

Когда использовать: Для нового чата необходима та же информация (соглашения, прошлые решения, известные ошибки), которую вы уже узнали в предыдущем чате.

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

Существующий банк памяти для этого проекта — Заполните его во время обычной работы с помощью Memory_bank_write.

Поток

Перечислите файлы, которые уже есть в банке проекта.

Вызовите list_project_files для проекта=acme-api.✓ Скопировано

→ архитектура.md, решения.md, открытые вопросы.md и т. д.
Загрузите соответствующее подмножество

Прежде чем приступить к выполнению задания, прочтите решения.md и open-questions.md.✓ Скопировано

→ Агент ссылается на предыдущие решения вместо того, чтобы переспрашивать

Итог: Новые сеансы начинаются с тепла, а не с холода; вы каждый раз перестаете платить сбор за вход.

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

Позвольте банку вырасти в один гигантский файл — Разделение по задачам — решения, архитектура, открытые вопросы, Runbook — чтобы агент загружал только то, что ему нужно.

Сочетать с: codebase-memory

Версия памяти вашего агента в git, как и любой другой документ проекта.

👤 Команды, которые хотят, чтобы память сохранялась на всех машинах и среди участников ⏱ ~20 min intermediate

Когда использовать: Вы хотите, чтобы файлы памяти просматривались, изменялись и делились ими с товарищами по команде.

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

Git-репозиторий для размещения банка — git init внутри MEMORY_BANK_ROOT или подпапки проекта

Поток

Сделать корень репо

Превратите ~/ai-memory в репозиторий git; добавьте .gitignore для всего конфиденциального.✓ Скопировано

→ Стандартная структура репозитория git
Разрешить агенту обновлять память во время сеансов

После исправления ошибки вызовите Memory_bank_update, чтобы записать основную причину в bugs.md.✓ Скопировано

→ Новый дифф, готовый к коммиту
Зафиксируйте и нажмите

Просмотрите разницу памяти, зафиксируйте, нажмите.✓ Скопировано

→ Товарищи по команде привлекают внимание, а их агенты немедленно делятся контекстом.

Итог: Память агента становится первоклассным артефактом проекта.

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

Передача секретов, которые записал агент — Добавьте сканер предварительной фиксации (например, gitleaks) перед отправкой репозитория в память.

Сочетать с: github · git

Комбинации

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

memory-bank-mcp + filesystem

Банк памяти хранит записи агента; файловая система читает код, на который они ссылаются

Считайте решения.md из банка памяти, затем откройте файлы, на которые он ссылается, в src/.✓ Скопировано

memory-bank-mcp + github

После объединения PR запишите результат в банк памяти проекта.

Подведите итоги объединенного PR № 412 и обновите Memory-bank/acme-api/decisions.md.✓ Скопировано

memory-bank-mcp + codebase-memory

Два взаимодополняющих слоя памяти — графическая память + удобочитаемые заметки.

Объедините граф символов кодовой базы-памяти с описанием в Memory-bank/architecture.md.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать
memory_bank_read	project: str, file: str	Извлеките имеющуюся память перед планированием
memory_bank_write	project: str, file: str, content: str	Создайте новый файл памяти
memory_bank_update	project: str, file: str, content: str	Изменить существующий файл памяти (не удается, если он отсутствует)
list_projects	(none)	Узнайте, в каких проектах уже есть банки памяти
list_project_files	project: str	Прежде чем читать, посмотрите, какие файлы памяти доступны.

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

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

Квота API: Нет внешнего API
Токенов на вызов: Зависит от размера файла; типичная купюра 200–2000 жетонов
Деньги: Бесплатно — работает локально
Совет: Файлы памяти должны быть короткими и привязанными к темам; загрузка файла размером 50 КБ приводит к потере контекста при каждом вызове.

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

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

Хранение учётных данных: Никаких учетных данных. Путь MEMORY_BANK_ROOT — единственная конфигурация.

Исходящий трафик: Никаких сетевых вызовов — операции чтения и записи выполняются в локальной файловой системе под MEMORY_BANK_ROOT.

Не устанавливайте MEMORY_BANK_ROOT в качестве домашнего корня или корня проекта — установите для него выделенную папку, чтобы агенты не могли читать несвязанные файлы.
Проверьте, что агенты записывают в память, прежде чем отправлять это в git; Стенограммы чата могут включать секреты, которые агент видел ранее.

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

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

Ошибка: MEMORY_BANK_ROOT не установлен.

Установите переменную env в конфигурации вашего клиента MCP и перезапустите клиент.

Проверить: echo $MEMORY_BANK_ROOT

ENOENT при чтении файла

Сначала вызовите list_project_files — имя файла должно существовать точно.

Проверить: ls $MEMORY_BANK_ROOT/<project>/

EACCES при записи

Убедитесь, что процесс MCP имеет разрешение на запись в MEMORY_BANK_ROOT.

Проверить: touch $MEMORY_BANK_ROOT/.probe && rm $MEMORY_BANK_ROOT/.probe

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

Memory Bank MCP в сравнении

Альтернатива	Когда использовать	Компромисс
memory (official)	Вам нужен график знаний, а не файловые заметки	График структурирован, но менее доступен для редактирования человеком
memory-service	Вам нужен семантический поиск по памяти	Более тяжелая установка; требуются вложения
Cline Memory Bank (inline)	Вы используете только Cline и не нуждаетесь в совместном использовании между IDE.	Заблокировано для Клайна

Ещё

Ресурсы

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

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

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