loading…
Search for a command to run...
loading…
MCP Server for local knowledge management. Semantic + keywords + tags
MCP Server for local knowledge management. Semantic + keywords + tags
Структура появляется из содержания.
MIT License Python 3.10+ MCP PyPI DOI
Когда база знаний растёт — размещение документов по папкам перестаёт работать. Агент видит файлы, но не понимает, как связаны ваши идеи и документы.
NOUZ даёт агенту семантические координаты. Каждая заметка получает знак домена, уровень в иерархии и связи с другими заметками. Домен присваивается именно из содержания файла, или же вами вручную, если вы хотите строгую иерархию.
Ядра — домены, которые вы задаёте сами. Примеры: Технология / Наука / Гуманитарные, или Системное мышление / Данные / Код. Сервер превращает описания в векторы-эталоны и проецирует заметки на эти оси.
Знак (sign) — координата заметки в пространстве доменов. Квант про нейросети лежит в модуле системного мышления, но по тексту тянет к вычислениям → знак составится из двух ядер.
DAG вместо дерева — направленный ациклический граф. У заметки может быть несколько родителей, несколько типов связей.
Три режима работы:
| Режим | Граф | Семантика | Иерархия |
|---|---|---|---|
| LUCA | ✅ | ❌ | Свободная |
| PRIZMA | ✅ | Ядра, мосты, drift | Свободная |
| SLOI | ✅ | ✅ | Строгая 5-уровневая |
config.yaml — чем каждый занимается, на каком языке говорит.core_mix — агрегированный состав ядер от всех своих квантов. Если sign модуля расходится с core_mix — сервер сообщает о core_drift.Три типа мостов находят связи между заметками из разных доменов: семантические (тексты близки), теговые (концепты пересекаются), аналогические (похожая роль в графе).
Вдохновлено исследованием рекурсивной самоорганизации — статья на Zenodo.
pip install nouz-mcp
OBSIDIAN_ROOT=/path/to/vault nouz-mcp
Без config.yaml сервер стартует в режиме LUCA — граф без семантики, работает сразу.
Или из исходников:
git clone https://github.com/KVANTRA-dev/NOUZ-MCP
cd NOUZ-MCP
pip install -r requirements.txt
OBSIDIAN_ROOT=./vault python server.py
Подключение к Claude Desktop, Cursor, Opencode или любому MCP-клиенту:
{
"mcpServers": {
"nouz": {
"command": "nouz-mcp",
"env": {
"OBSIDIAN_ROOT": "/path/to/vault",
"MODE": "prizma",
"EMBED_API_URL": "http://127.0.0.1:1234/v1"
}
}
}
}
| Инструмент | Зачем |
|---|---|
suggest_metadata |
Знак, уровень, мосты, drift-предупреждения |
write_file |
Записать заметку с YAML-разметкой |
read_file |
Прочитать заметку + метаданные |
calibrate_cores |
Обновить векторы-эталоны ядер |
recalc_signs |
Пересчитать знаки всех заметок |
recalc_core_mix |
Пересчитать агрегацию снизу вверх |
index_all |
Переиндексировать всю базу |
format_entity_compact |
Формула (дети)[знак]{родители} |
embed |
Получить вектор для текста |
list_files |
Список с фильтрами по уровню, знаку |
get_children / get_parents |
Траверс графа |
suggest_parents |
Найти родителей для сироты |
Минимальный config.yaml:
mode: prizma
etalons:
- sign: T
name: Технология
text: "программирование архитектура инфраструктура машинное обучение нейросети алгоритмы"
- sign: S
name: Наука
text: "физика математика космология научная методология данные эксперимент"
- sign: H
name: Гуманитарные
text: "философия психология история литература этика когнитивные науки"
thresholds:
confident_spread: 60.0
semantic_bridge_threshold: 0.55
После настройки запустите calibrate_cores — сервер создаст эталонные векторы.
| Переменная | По умолчанию | Описание |
|---|---|---|
OBSIDIAN_ROOT |
./obsidian |
Путь к хранилищу |
MODE |
luca |
luca, prizma или sloi |
EMBED_PROVIDER |
openai |
openai, lmstudio, ollama, gigachat |
EMBED_API_URL |
http://127.0.0.1:1234/v1 |
Эндпоинт для эмбеддингов |
EMBED_API_KEY |
(пусто) | API-ключ, если нужен |
EMBED_MODEL |
(пусто) | Имя модели |
| Компонент | Локально? |
|---|---|
| Эмбеддинги (LM Studio / Ollama) | ✅ Да |
| Ваши заметки | ✅ Да |
| Сервер NOUZ | ✅ Да |
| Контекст AI-агента (Claude, ChatGPT) | ❌ Уходит в облако |
Всё критичное остаётся на вашей машине.
git clone https://github.com/KVANTRA-dev/NOUZ-MCP
cd NOUZ-MCP
pip install -e .
python -m pytest test_server.py
MIT License © 2026 KVANTRA
Косинусы считаются. Синтаксис меняется. Семантика остаётся.
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"nouz-mcp-server": {
"command": "npx",
"args": []
}
}
}