Инструменты MCP
NOUZ предоставляет 13 инструментов через Model Context Protocol. Доступность зависит от режима:
| # | Инструмент | LUCA | PRIZMA | SLOI |
|---|---|---|---|---|
| 1 | read_file | да | да | да |
| 2 | write_file | да | да | да |
| 3 | list_files | да | да | да |
| 4 | get_children | да | да | да |
| 5 | get_parents | да | да | да |
| 6 | format_entity_compact | да | да | да |
| 7 | index_all | да | да | да |
| 8 | suggest_metadata | — | да | да |
| 9 | suggest_parents | — | да | да |
| 10 | embed | — | да | да |
| 11 | calibrate_cores | — | да | да |
| 12 | recalc_signs | — | да | да |
| 13 | recalc_core_mix | — | да | да |
Чтение и запись
read_file
Прочитать заметку Obsidian с YAML frontmatter. Возвращает метаданные (type, level, sign, parents, tags) и контент. Переиндексирует файл в базе данных.
write_file
Создать или обновить заметку с frontmatter. Проверяет граф на циклы перед записью. Автоматически синхронизирует parents и parents_meta.
list_files
Список проиндексированных файлов с фильтрами: по level, sign, subfolder, или no_metadata (файлы без YAML).
Навигация по графу
get_children
Все потомки узла (прямые и транзитивные) из индекса DAG.
get_parents
Родительские связи файла. Возвращает {entity, link_type} для каждой связи.
format_entity_compact
Компактная формула позиции узла: (дети)[узел]{родители}. Быстрый способ увидеть окружение заметки в графе.
Семантика PRIZMA / SLOI
suggest_metadata
Главный инструмент для ИИ-агентов. Анализирует контент и предлагает: доменный знак, уровень иерархии, теги, семантические и аналогические мосты, ошибки иерархии. Возвращает proposed: true — решение за человеком.
suggest_parents
Находит семантически похожие заметки по cosine similarity. Предлагает как потенциальных родителей для «осиротевших» заметок.
embed
Сгенерировать вектор эмбеддинга для произвольного текста. Полезно для проверок сходства ad-hoc.
Обслуживание базы данных PRIZMA / SLOI
index_all
Переиндексировать все markdown-файлы в хранилище. С with_embeddings=true — также пересчитать векторы (медленнее, требует провайдер эмбеддингов).
calibrate_cores
Пересчитать эталонные векторы доменов из config.yaml. После запуска проверяйте pairwise cosine в двух вариантах: сырой и mean-centered. Хороший результат: mean-centered значительно ниже сырого. Если mean-centered между разными доменами примерно равен значению внутри одного домена — эталоны пересекаются, стоит переформулировать.
recalc_signs
Переклассифицировать все файлы по эмбеддингам. Обновляет sign_auto и sign_source в БД (не трогает YAML). Используйте dry_run=true для предпросмотра.
recalc_core_mix
Агрегация снизу вверх: кванты (L4) → модули (L3) → паттерны (L2). Каждый родитель получает среднее доменное распределение от своих детей.