rei-memory-mcp

MCP-сервер только для чтения, который позволяет Rei / Claude запрашивать SEED_KERNEL из Rei-AIOS (1 677+ теорий по состоянию на 2026-08-19) по полнотекстовому поиску, ID или STEP.

Фаза 1 — только чтение. Путь записи не предоставляется как MCP-инструмент. Загрузка — это одноразовый скрипт; добавление и продвижение теорий относится к Фазе 2 (промежуточная таблица seed_propose).

Принцип проектирования

Трёхуровневая таксономия (proven / hypothesis / speculative) — это обязательное поле схемы. Теория без уровня не может быть загружена. Дисциплина эпидемической гигиены обеспечивается схемой, а не человеческим вниманием.

Related MCP server: Ek-Chuah MCP

Инструменты

Установка

Python 3.11+ и SQLite 3.34+ (для триграммного токенизатора FTS5 — входит в состав Python 3.11+).

# from repo root
python -m venv .venv
.venv/Scripts/activate            # Windows
source .venv/bin/activate         # Unix
pip install -e '.[dev]'

Создание базы данных

SEED_KERNEL хранится как исходный код TypeScript в rei-aios/src/axiom-os/seed-kernel*.ts. Выгрузите его в JSONL, затем загрузите:

# 1. dump (run inside the rei-aios repo; script is bundled there)
cd path/to/rei-aios
npx tsx scripts/dump-seed-kernel-json.ts > /path/to/rei-memory-mcp/data/seed-kernel-dump.jsonl

# 2. ingest into SQLite
cd path/to/rei-memory-mcp
python scripts/ingest.py \
    --input data/seed-kernel-dump.jsonl \
    --db    data/seed_kernel.db

И data/*.jsonl, и data/*.db находятся в .gitignore — перегенерируйте по мере необходимости.

Запуск MCP-сервера

# stdio transport (default)
python -m rei_memory_mcp.server
# or via console script:
rei-memory-mcp

Путь к БД берётся из REI_MEMORY_DB (по умолчанию: ./data/seed_kernel.db).

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

Добавьте в настройки MCP вашего Claude Desktop (скорректируйте пути):

{
  "mcpServers": {
    "rei-memory": {
      "command": "python",
      "args": ["-m", "rei_memory_mcp.server"],
      "cwd": "C:/Users/user/rei-memory-mcp",
      "env": {
        "REI_MEMORY_DB": "C:/Users/user/rei-memory-mcp/data/seed_kernel.db"
      }
    }
  }
}

Тесты

pytest

Тест на японские запросы (test_search.py::test_japanese_query_hits) — ключевой сигнал: если он падает, триграммный токенизатор сломан, и поиск молча бесполезен.

Честная область применения

• Только чтение. Пишущего MCP-инструмента намеренно не существует. Ошибочные воспоминания не должны иметь быстрого пути к формированию.

• Триграммный японский. Запросы длиной 2 символа или короче не будут соответствовать японскому тексту (так работает триграммный токенизатор). Используйте запросы из 3+ символов.

• Покрытие STEP. Только ~3% текущих записей SEED_KERNEL содержат маркер STEP N в тексте тела. seed_list_steps честно сообщает об этом.

• Форма id. Текущий SEED_KERNEL смешивает три паттерна ID (T-\d+, invented-*, kebab-case slug). Принимаются все три; без переформатирования.

• Без векторного поиска. Триграммы FTS5 — вся история поиска в Фазе 1. Если этого окажется недостаточно, Фаза 2 может добавить эмбеддинги параллельно — не заменяя.

Дорожная карта (не реализовано)

• Фаза 2 — промежуточная таблица seed_propose + одобрение человеком → продвижение в theories. Прямая запись в theories не будет предоставлена как инструмент.

• Фаза 3 — таблица истории продвижений, чтобы дуга теории (hypothesis → proven) сама была артефактом.

• Фаза 4 — затухание по счётчику обращений для ранжирования. Строки с immutable: true не подлежат затуханию; ничего никогда не удаляется.

Лицензия

AGPL-3.0 (с условиями коммерческой двойной лицензии — см. LICENSE). Соответствует основному репозиторию rei-aios.

急がず、ゆっくりと。種は育ちます。