Nouz — MCP-сервер для Claude Code: что делает и как установить
Связывает Markdown-заметки в Obsidian или Logseq с ИИ-агентом, выстраивает граф без циклов и находит смысловые пересечения между темами.
claude mcp add --env OBSIDIAN_ROOT=<OBSIDIAN_ROOT> --env NOUZ_CONFIG=<NOUZ_CONFIG> --env NOUZ_DATABASE_NAME=<NOUZ_DATABASE_NAME> --env NOUZ_DATABASE_PATH=<NOUZ_DATABASE_PATH> --env EMBED_ENABLED=<EMBED_ENABLED> --transport stdio nouz -- uvx nouz-mcpЧто делает Nouz
Сервер превращает хранилище заметок в направленный ациклический граф (DAG). При сохранении файлов Nouz сопоставляет их текст с заданными предметными ядрами и выставляет доменные знаки. Если заметка постепенно меняет тему и уходит в другую область, инструмент зафиксирует расхождение core_drift в индексе SQLite.
Внутри предусмотрено разделение на режимы. Без файла config.yaml сервер запускается в простом графовом виде LUCA. Для семантического анализа и 5-уровневой структуры SLOI потребуется локальный сервер эмбеддингов вроде Ollama или LM Studio. Связи между далёкими темами строятся через семантические мосты по смысловой близости фрагментов текста.
Для полноценного векторного поиска нужен Python 3.10+ и поднятый эндпоинт EMBED_API_URL, иначе сложные режимы классификации останутся недоступны.
Какие задачи решает
- связать разрозненные Markdown-заметки в строгий граф без циклов
- автоматически определить домен новой записи через векторные эталоны
- обнаружить смысловые мосты между записями из разных областей знаний
- отследить уход содержания заметки от первоначальной темы через метрику дрифта
Примеры запросов агенту
- Проверь неразмеченные заметки в хранилище через
process_orphansи предложи для них родителей. - Запусти
suggest_metadataдля текущей статьи и покажи возможные семантические мосты. - Пересчитай доменный профиль узлов базы командой
recalc_core_mix.
Как установить Nouz
Командой платформы
claude mcp add --env OBSIDIAN_ROOT=<OBSIDIAN_ROOT> --env NOUZ_CONFIG=<NOUZ_CONFIG> --env NOUZ_DATABASE_NAME=<NOUZ_DATABASE_NAME> --env NOUZ_DATABASE_PATH=<NOUZ_DATABASE_PATH> --env EMBED_ENABLED=<EMBED_ENABLED> --transport stdio nouz -- uvx nouz-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from nouz-mcp <команда>
Командой платформы
codex mcp add nouz --env OBSIDIAN_ROOT=<OBSIDIAN_ROOT> --env NOUZ_CONFIG=<NOUZ_CONFIG> --env NOUZ_DATABASE_NAME=<NOUZ_DATABASE_NAME> --env NOUZ_DATABASE_PATH=<NOUZ_DATABASE_PATH> --env EMBED_ENABLED=<EMBED_ENABLED> -- uvx nouz-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from nouz-mcp <команда>
Файл настроек
{
"mcpServers": {
"nouz": {
"command": "uvx",
"args": [
"nouz-mcp"
],
"env": {
"OBSIDIAN_ROOT": "<OBSIDIAN_ROOT>",
"NOUZ_CONFIG": "<NOUZ_CONFIG>",
"NOUZ_DATABASE_NAME": "<NOUZ_DATABASE_NAME>",
"NOUZ_DATABASE_PATH": "<NOUZ_DATABASE_PATH>",
"EMBED_ENABLED": "<EMBED_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from nouz-mcp <команда>
Файл настроек
{
"servers": {
"nouz": {
"type": "stdio",
"command": "uvx",
"args": [
"nouz-mcp"
],
"env": {
"OBSIDIAN_ROOT": "<OBSIDIAN_ROOT>",
"NOUZ_CONFIG": "<NOUZ_CONFIG>",
"NOUZ_DATABASE_NAME": "<NOUZ_DATABASE_NAME>",
"NOUZ_DATABASE_PATH": "<NOUZ_DATABASE_PATH>",
"EMBED_ENABLED": "<EMBED_ENABLED>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from nouz-mcp <команда>
Командой платформы
gemini mcp add -e OBSIDIAN_ROOT=<OBSIDIAN_ROOT> -e NOUZ_CONFIG=<NOUZ_CONFIG> -e NOUZ_DATABASE_NAME=<NOUZ_DATABASE_NAME> -e NOUZ_DATABASE_PATH=<NOUZ_DATABASE_PATH> -e EMBED_ENABLED=<EMBED_ENABLED> nouz uvx nouz-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from nouz-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Nouz
Как установить Nouz в Claude Code?
Выполните команду claude mcp add nouz-mcp -- uvx nouz-mcp. Если нужно передать пути к заметкам и базе сразу, используйте полный вариант: `claude mcp add --env OBSIDIAN_ROOT=<OBSIDIAN_ROOT> --env NOUZ_CONFIG=<NOUZ_CONFIG> --env NOUZ_DATABASE_NAME=<NOUZ_DATABASE_NAME> --env NOUZ_DATABASE_PATH=<NOUZ_DATABASE_PATH> --env EMBED_ENABLED=<EMBED_ENABLED> --transport stdio nouz -- uvx nouz-mcp`.
Для чего нужен Nouz?
Он служит мостом между базой заметок Markdown и языковой моделью. Сервер автоматически классифицирует документы, находит смысловые связи между ними и предупреждает об искажении структуры графа.
Какие внешние сервисы требуются для работы семантики?
Для расчёта векторов и поиска по чанкам нужен локальный генератор эмбеддингов, например Ollama или LM Studio по адресу EMBED_API_URL. Без конфига и векторов сервер работает в базовом графовом режиме LUCA.
