MCP-сервер векторной памяти

Семантическое хранилище памяти для ИИ-ассистентов. Сохраняйте решения, шаблоны и контекст, которые сохраняются между сессиями.

Локальный MCP-сервер, предоставляющий векторное хранилище памяти. Использует локальные эмбеддинги и SQLite с sqlite-vec для быстрого и приватного семантического поиска — всё в одном файле.

Возможности

• Локально и приватно — все эмбеддинги генерируются локально (all-MiniLM-L6-v2, 384 измерения), данные хранятся в одном файле SQLite

• Семантический поиск — гибридный векторный и полнотекстовый поиск с ранжированием на основе намерений

• Пакетные операции — сохранение, обновление, удаление и получение нескольких воспоминаний одновременно

• Контрольные точки сессии (Waypoints) — сохранение и восстановление контекста проекта между сессиями

• История диалогов — индексация и поиск по транскриптам сессий Claude Code

• MCP Native — стандартный протокол, работает с любым MCP-совместимым клиентом

Related MCP server: Memorious MCP

Установка

Существует два способа установки Vector Memory, в зависимости от того, какой уровень интеграции вам нужен.

Вариант А: Плагин Claude Code (рекомендуется)

Установите как плагин, чтобы получить полный функционал: MCP-сервер, хуки жизненного цикла сессии, навыки работы с контрольными точками и мониторинг контекста — всё управляется автоматически.

# Add the marketplace
claude plugin marketplace add AerionDyseti/vector-memory-mcp

# Install the plugin
claude plugin install vector-memory@vector-memory-mcp

Это клонирует репозиторий и запускает MCP-сервер напрямую из исходного кода. Хуки обрабатывают события запуска/очистки/сжатия сессии, а навыки предоставляют /waypoint:set, /waypoint:get и рекомендации по использованию памяти.

Вариант Б: Только MCP-сервер

Установите только MCP-сервер через npm, если вам нужно хранилище памяти без хуков или навыков, или если вы используете MCP-клиент, отличный от Claude Code.

bun install -g @aeriondyseti/vector-memory-mcp

При первой установке загружаются модели машинного обучения (~90 МБ). Это может занять минуту.

Затем добавьте в конфигурацию вашего MCP-клиента (например, ~/.claude/settings.json):

{
  "mcpServers": {
    "vector-memory": {
      "type": "stdio",
      "command": "bunx",
      "args": ["--bun", "@aeriondyseti/vector-memory-mcp"]
    }
  }
}

Системные требования

• Bun 1.0+

• MCP-совместимый клиент (Claude Code, Claude Desktop и т.д.)

Инструменты

Перезапустите ваш MCP-клиент после установки. Теперь вам доступны:

Использование

Сохранение воспоминания:

You: "Remember that we use Drizzle ORM for database access"
Assistant: [calls store_memories]

Поиск воспоминаний:

You: "What did we decide about the database?"
Assistant: [calls search_memories with relevant query]

Контрольные точки сессии:

You: "Save context for next session"
Assistant: [calls set_waypoint with summary, completed items, next steps]

История диалогов (требуется --enable-history):

You: "What did we discuss about the API design last week?"
Assistant: [calls search_memories with history_only: true, history_before/after filters]

Конфигурация

Флаги CLI:

Каналы релизов

Пользователи плагина: Плагин отслеживает ветку репозитория по умолчанию. Чтобы переключить каналы, переустановите из конкретной ветки или тега.

Пользователи npm: Стабильный релиз предоставляется по умолчанию:

bun install -g @aeriondyseti/vector-memory-mcp

Предварительные каналы доступны для тестирования предстоящих изменений. Они нестабильны и могут сломаться без предупреждения — используйте на свой страх и риск.

# Install the dev channel
bun install -g @aeriondyseti/vector-memory-mcp@dev

# Pin to a specific pre-release version
bun install -g @aeriondyseti/vector-memory-mcp@2.1.0-dev.1

# Go back to stable
bun install -g @aeriondyseti/vector-memory-mcp@latest

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

Миграция с 1.x (LanceDB)

Версия 2.0 заменила LanceDB на SQLite (sqlite-vec) для хранения. Если у вас есть существующие данные из 1.x, сервер обнаружит их автоматически и предложит выполнить миграцию:

vector-memory-mcp migrate

Это прочитает вашу директорию LanceDB, создаст новый файл SQLite и выведет инструкции по их замене. Ваши исходные данные сохраняются до тех пор, пока вы не удалите их вручную.

Что изменилось:

• Хранилище: Директория LanceDB (~845 файлов) → один файл .db

• Зависимости: 223 МБ (@lancedb/lancedb + apache-arrow) → 24 КБ (sqlite-vec)

• Среда выполнения: Поддержка Node.js прекращена, требуется Bun (для bun:sqlite)

Разработка

git clone https://github.com/AerionDyseti/vector-memory-mcp.git
cd vector-memory-mcp
bun install

bun run test      # Run all tests
bun run dev       # Watch mode
bun run typecheck # Type checking

Смотрите CHANGELOG.md для истории релизов и ROADMAP.md для планируемых функций.

Участие в разработке

Вклад приветствуется! См. issues для областей, в которых нам нужна помощь.

Лицензия

MIT - см. LICENSE

Создано с использованием MCP SDK, sqlite-vec и Transformers.js