semiotronika avatar

Nouz

semiotronika/nouz-mcp

Brings semantic classification and DAG hierarchy to Obsidian vaults and Markdown directories. Exposes tools to auto-classify notes into domains using local embeddings (via LM Studio or Ollama), suggest parent/child relationships without cycles, detect semantic bridges between notes in different domains, and track concept drift when a note's content diverges from its declared domain. You configure domain "cores" with text descriptions, then call suggest_metadata to get signs and hierarchy proposals, or process_orphans to batch-tag unstructured files. Also includes chunk_text and search_chunks for RAG workflows. Works in three modes: LUCA for plain graphs, PRIZMA for semantic analysis, and SLOI for strict five-level hierarchies. Install via pip, point it at your vault, and wire it into Claude Desktop or any MCP client.

GitHub stars
24
tools
18
transport
STDIO
env vars
8
last updated
Sep 2, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

suggest_metadataЗнак, уровень, мосты, дрифт-предупреждения

Знак, уровень, мосты, дрифт-предупреждения

No parameter schema in public metadata yet.

write_fileЗаписать заметку с YAML-разметкой

Записать заметку с YAML-разметкой

No parameter schema in public metadata yet.

update_metadataОбновить только YAML, не меняя текст заметки

Обновить только YAML, не меняя текст заметки

No parameter schema in public metadata yet.

read_fileПрочитать заметку + метаданные

Прочитать заметку + метаданные

No parameter schema in public metadata yet.

calibrate_coresОбновить векторы-эталоны ядер

Обновить векторы-эталоны ядер

No parameter schema in public metadata yet.

recalc_signsПересчитать знаки всех заметок

Пересчитать знаки всех заметок

No parameter schema in public metadata yet.

recalc_core_mixПересчитать доменный профиль родителей по дочерним содержательным узлам

Пересчитать доменный профиль родителей по дочерним содержательным узлам

No parameter schema in public metadata yet.

index_allПереиндексировать всю базу; в PRIZMA/SLOI с `with_embeddings=true` также обновляет эмбеддинги файлов/чанков

Переиндексировать всю базу; в PRIZMA/SLOI с `with_embeddings=true` также обновляет эмбеддинги файлов/чанков

No parameter schema in public metadata yet.

embedПолучить вектор для текста в PRIZMA/SLOI

Получить вектор для текста в PRIZMA/SLOI

No parameter schema in public metadata yet.

chunk_textРазрезать Markdown-текст на стабильные чанки в PRIZMA/SLOI

Разрезать Markdown-текст на стабильные чанки в PRIZMA/SLOI

No parameter schema in public metadata yet.

chunk_fileРазрезать тело одной заметки на стабильные чанки в PRIZMA/SLOI

Разрезать тело одной заметки на стабильные чанки в PRIZMA/SLOI

No parameter schema in public metadata yet.

search_chunksИскать по сохранённым chunk embeddings в PRIZMA/SLOI; по умолчанию снижает анизотропию

Искать по сохранённым chunk embeddings в PRIZMA/SLOI; по умолчанию снижает анизотропию

No parameter schema in public metadata yet.

list_filesСписок с фильтрами по уровню, знаку

Список с фильтрами по уровню, знаку

No parameter schema in public metadata yet.

get_childrenПройти вниз по графу

Пройти вниз по графу

No parameter schema in public metadata yet.

get_parentsПройти вверх по графу

Пройти вверх по графу

No parameter schema in public metadata yet.

suggest_parentsНайти родителей для сироты

Найти родителей для сироты

No parameter schema in public metadata yet.

add_entityСоздать сущность в один шаг (автоматический знак и иерархия, теги только явно)

Создать сущность в один шаг (автоматический знак и иерархия, теги только явно)

No parameter schema in public metadata yet.

process_orphansАвтозаполнение файлов без разметки

Автозаполнение файлов без разметки

No parameter schema in public metadata yet.

Sponsors

Configuration

OBSIDIAN_ROOTdefault: ./obsidian

Path to Obsidian vault

NOUZ_CONFIG

Absolute path to config.yaml; if omitted, server looks in current working directory

NOUZ_DATABASE_NAMEdefault: obsidian_kb.db

SQLite cache filename inside OBSIDIAN_ROOT

NOUZ_DATABASE_PATH

Full SQLite cache path; takes precedence over NOUZ_DATABASE_NAME

EMBED_ENABLEDdefault: true

Enable embedding-based features

EMBED_PROVIDERdefault: openai

Embedding provider: openai-compatible endpoint or ollama

EMBED_MODEL

Embedding model name

EMBED_API_URLdefault: http://127.0.0.1:1234/v1

Embedding API endpoint

Readme

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

Структура появляется из содержания.

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

MIT License Python 3.10+ MCP SDK v2 PyPI

NOUZ работает на MCP Python SDK v2.

🇬🇧 English version


Зачем нужен Nouz

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

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

View the full README on GitHub

Details

Repository
github.com/semiotronika/nouz-mcp
Category
Documents & Knowledge
Package
nouz-mcp
Transport
STDIO
Registry
MCP registry, active

More from semiotronika

Related Documents & Knowledge MCP servers

View all
1xt765 avatarMCP Document Readerxt765/mcp_documents_readerAn MCP enabled multi-format document reader supporting DOCX, PDF, TXT, and Excel files21stars
2the-40-thieves avatarReliquary-TCthe-40-thieves/reliquary-tcGoverned Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.13stars
3linxule avatarMinerUlinxule/mineru-mcpMinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.10stars
4openarx-ai avatarOpenArxopenarx-ai/openarx-coreOpen scientific and engineering knowledge for AI agents: search, evidence, document publishing.0stars
5copperline-labs avatarRendex: Rendering API for Images, PDFs & Content Extractioncopperline-labs/rendex-mcpRender HTML, Markdown, or URLs to images, PDF, or branded artifacts; extract and watch pages.6stars
6raalarcon9705 avatarJira Mcpraalarcon9705/jira-mcpJira & Confluence MCP: 24 tools for issues, sprints, comments, transitions & wiki. Run via npx.4stars