NOUZ MCP Server

NOUZ — Семантический MCP-сервер для вашей базы знаний

Работает с Obsidian, Logseq и любыми директориями Markdown-файлов.

NOUZ выступает прослойкой между вашей базой заметок и AI-агентом. Он помогает превратить разрозненные Markdown-файлы в граф, с которым удобно работать и вам, и агенту:
-

Автоматическая классификация (Семантика)Вы задаете "Ядра" — базовые домены вашей базы. Когда вы добавляете новую заметку, NOUZ читает ее текст, сравнивает векторы и предлагает доменный знак или комбинацию доменов.

Поиск связей между заметкамиСервер строит направленный структурный граф:hierarchyдержится как DAG без циклов, а дополнительные смысловые связи живут рядом:

- Семантические мосты:две заметки из разных доменов указывают на одну и ту же идею.
- Явные теговые связи можно хранить вручную в YAML.

Отслеживание эволюции базы (Дрифт)NOUZ хранит доменный профиль содержательных узлов и может сравнить его с заявленным знаком. Если модуль описан как один домен, а его профиль постепенно тянет в другой, сервер покажет расхождение (core_drift).

В зависимости от ваших задач NOUZ работает в трех режимах: от простого графа (LUCA) до строгой 5-уровневой иерархии (SLOI).
- Вы описываете домены вconfig.yaml— какую область покрывает каждый домен и по каким признакам текста его узнавать.
- Сервер превращает описания в векторы-эталоны (локально, через LM Studio или Ollama).
- Каждая новая заметка проецируется на эти оси. Знак определяется содержанием, или вами.

Здесь важно разделять два слоя.artifact_signsописывают форму L5-артефактов: лог, источник, гипотеза, спецификация и так далее. Эти знаки не агрегируются в доменный знак L4. Лог остается логом, источник остается источником.

core_mix— не сумма типов артефактов. Это доменный профиль в SQLite-индексе. L4/L3/L2 получают его из собственного текста приrecalc_signs, а родительские узлы могут затем получить усредненный профиль дочерних содержательных узлов черезrecalc_core_mix.core_driftпоявляется, когда сохраненный доменный профиль и текущийsignуказывают на разные ведущие домены.

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

pip install nouz-mcp OBSIDIAN_ROOT=/path/to/vault nouz-mcp

Безconfig.yamlсервер стартует в режимеLUCA— граф без семантики, работает сразу.

Чтобы включить семантический режим, создайте локальный конфиг из шаблона:

Copy-Item config.template.yaml config.yaml

git clone https://github.com/Semiotronika/NOUZ-MCP cd NOUZ-MCP pip install -r requirements.txt cp config.template.yaml config.yaml OBSIDIAN_ROOT=./vault python server.py

Подключение к Claude Desktop, Cursor, Opencode или любому MCP-клиенту:

{ "mcpServers": { "nouz": { "command": "nouz-mcp", "env": { "OBSIDIAN_ROOT": "/path/to/vault", "NOUZ_CONFIG": "/absolute/path/to/config.yaml", "EMBED_API_URL": "http://127.0.0.1:1234/v1" } } } }

mode: prizma etalons: - sign: S name: Systems Analysis text: > Methodology for analysing complex objects: feedback loops, emergent properties, self-regulation, bifurcation points. Cybernetics, synergetics, dissipative structures, catastrophe theory, autopoiesis — tools for understanding how the whole exceeds the sum of its parts. Not data and not code — a way of thinking about how parts form a whole and why systems behave non-linearly. - sign: D name: Data & Science text: > Physics and cosmology: from subatomic particles to the large-scale structure of the Universe. Lagrangians, curvature tensors, scattering cross-sections, quarks, bosons, fermions, plasma, vacuum fluctuations, cosmic microwave background, cosmological constant, decoherence. Pure science about the nature of matter, energy and spacetime. - sign: E name: Engineering text: > Software engineering, machine learning and infrastructure: writing and debugging code, deployment, containerisation, neural networks, inference, tokenisation, data serialisation, microservices, CI/CD, automated testing, refactoring, Git, Docker, Kubernetes, APIs. The practical discipline of building computational systems from architecture to production. thresholds: sign_spread: 0.05 confident_spread: 60.0 pattern_second_sign_threshold: 30.0 semantic_bridge_threshold: 0.55 parent_link_threshold: 0.55 artifact_signs: - sign: n name: Note text: Short note, observation, fragment. - sign: c name: Concept text: Definition, concept, entity description. - sign: r name: Reference text: External source, documentation, link, citation. - sign: l name: Log text: Session log, chronology, dialogue record. - sign: u name: Update text: Update, release note, changelog entry. - sign: h name: Hypothesis text: Hypothesis, assumption, speculative idea. - sign: s name: Specification text: Technical specification, instruction, requirements.

После настройки запуститеcalibrate_cores— сервер создаст эталонные векторы. Проверьте попарные косинусы: mean-centered между разными доменами должен быть заметно ниже исходного. Если все пары примерно одинаковые — усильте различия в текстах. Отдельную проверку эталонов можно запустить из установленного пакета:nouz-calc-etalons --config config.yaml.

etalons— это смысловые домены, которые сравниваются через эмбеддинги.artifact_signs— тип материала для артефактов L5: заметка, концепт, ссылка, лог, обновление, гипотеза или спецификация. Это эвристическая метка. Домены обычно обозначаются заглавными буквами (S/D/E), а типы материала — строчными (n/c/r/l/u/h/s); их можно заменить в конфиге на любые другие значения. При необходимости для любого типа можно добавитьkeywords: тогда сервер будет использовать ваши слова для эвристики вместо встроенного RU/EN набора.

Вот фактические результаты для эталонов S/D/E с модельюtext-embedding-granite-embedding-278m-multilingual:

=== Pairwise Cosine (raw) === S↔D: 0.5894 S↔E: 0.5862 D↔E: 0.6022 === Pairwise Cosine (mean-centered) === S↔D: -0.5059 S↔E: -0.5117 D↔E: -0.4822

Отрицательные mean-centered значения здесь хороший результат: после вычитания среднего вектора домены хорошо расходятся. Smoke test эталонов текущимnouz-calc-etalons: S→99.6%, D→98.5%, E→98.1%. Это не оценка всей базы, а быстрая проверка, что каждый эталон после того же центрирования уверенно возвращается к своему знаку.

git clone https://github.com/Semiotronika/NOUZ-MCP cd NOUZ-MCP pip install -e . python -m compileall -q nouz_mcp pytest_smoke.py scripts python -m pytest -q python test_server.py

- 🌐semiotronika.ru
- 📦PyPI
- 🗂️Glama Registry
- 🐙GitHub

Authenticated MCP and agent gateway for Forge Cascade private AI memory, provenance, graph search, and capsule lineage.