VecMory

MCP-сервер контекстной памяти для AI-агентов.

Хранит цепочки запрос -> ошибка -> решение как граф с типизированными рёбрами. Эмбеддинг локальный (CPU, без внешних API). Данные живут в таблице Integram.

Установка

npm install vecmory

Related MCP server: local-memory-mcp

Быстрый старт с Claude Code

# Добавить MCP-сервер
claude mcp add vecmory npx vecmory

# Создать .env в корне проекта
cp node_modules/vecmory/.env.example .env
# Отредактировать .env — вписать VECMORY_TOKEN и ID полей

Перезапустите сессию Claude Code. Проверьте через /mcp — vecmory должен быть connected.

Альтернатива: bash-wrapper

Для глобальной установки или явной загрузки .env:

claude mcp add vecmory bash /path/to/vecmory/start-mcp.sh

Другие MCP-клиенты

{
  "mcpServers": {
    "vecmory": {
      "command": "npx",
      "args": ["vecmory"]
    }
  }
}

Инициализация (auth + загрузка модели эмбеддинга ~90MB) происходит лениво при первом вызове тулзы, не при старте MCP-сервера.

MCP-тулзы

Архитектура

Claude Code / AI-агент
        |
        | MCP stdio
        v
┌─────────────────────────────────┐
│  vecmory (npm, MCP-сервер)       │
│                                   │
│  MCP layer     — 4 тулзы         │
│  Embedder      — @xenova/transformers, 384-dim, CPU │
│  MemoryGraph   — узлы + типизированные рёбра        │
│  SearchEngine  — cosine brute-force                  │
│  DecayManager  — затухание неиспользуемых узлов      │
│  IntegramHTTP  — HTTP-клиент к Integram API          │
└────────────┬────────────────────┘
             |  HTTP (fetch)
             v
┌─────────────────────────────────┐
│  Integram PHP-бэкенд             │
│  ideav.ru                        │
└─────────────────────────────────┘

Структура узла

Каждый узел — запись в таблице Integram:

Типы рёбер

Пайплайны

remember(text, meta?)

1. Очистка текста (удаление ID, хешей, стоп-слов)

2. Эмбеддинг — 384-dim, L2-нормализация

3. Поиск top-k соседей по косинусу

4. Создание записи в Integram

5. Добавление рёбер SIMILAR_TO (forward + backward)

6. Добавление ребра FOLLOWED_BY к предыдущей записи сессии

7. Return { id, neighbors, scores }

recall(query, k?)

1. Эмбеддинг запроса

2. Cosine top-k

3. Обход рёбер на garlandDepth шагов (BFS)

4. Bump popularity_counter, reset decay_score

5. Return { nodes, garland, total }

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

Разработка

npm test          # запуск тестов
npm run test:watch  # watch-режим

Структура пакета

src/
  index.js              — VecMory class (оркестратор)
  mcp-server.js         — MCP stdio сервер (4 тулзы)
  integram-client.js    — HTTP-клиент к Integram API
  embedder.js           — @xenova/transformers wrapper
  search.js             — cosine brute-force
  graph.js              — рёбра, garland, обход
  decay.js              — затухание, архивация
  cleaner.js            — очистка текста
hooks/
  pre-recall.sh         — хук UserPromptSubmit → авто-recall
  post-remember.sh      — хук Stop → авто-remember
start-mcp.sh            — bash-wrapper (загружает .env)
test/
  *.test.js             — 72 теста

Зависимости

HTTP через globalThis.fetch (Node 18+). Минимум зависимостей.

Roadmap

• Claude Code хуки (auto-recall, auto-remember)

• FOLLOWED_BY автосвязывание последовательных записей

• Серверный косинус через формульные колонки Integram (тип 101) — research done, формула работает

• RECURSIVE-отчёт для серверного графа — заблокирован (neighbors=MEMO, не ref)

• A/B тестирование «с памятью / без»

Лицензия

Код: MIT — свободно использовать, форкать, менять.

Метод: патенты RU 2650032 C1 и US 11138174 B2 принадлежат ideav.ru. MIT-лицензия патентных прав не даёт.

Если вы используете VecMory вместе с Integram (https://ideav.ru/) — патентные права покрыты вашей лицензией Integram. Для других сценариев: alexey.ideav@gmail.com