Nouz MCP Server

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

Local serverstdioPython

What is the Nouz MCP MCP server?

Most developer tooling work still happens through a UI a human drives. Nouz MCP MCP server moves it into the conversation instead. Подключение к Claude Desktop, Cursor, Opencode или любому MCP-клиенту:.

Getting it running

Installation goes through your MCP client rather than a global install: point it at nouz-mcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • sign — S
  • suggest_metadata — Знак, уровень, мосты, дрифт-предупреждения
  • write_file — Записать заметку с YAML-разметкой
  • update_metadata — Обновить только YAML, не меняя текст заметки
  • read_file — Прочитать заметку + метаданные
  • calibrate_cores — Обновить векторы-эталоны ядер
  • recalc_signs — Пересчитать знаки всех заметок
  • recalc_core_mix — Пересчитать доменный профиль родителей по дочерним содержательным узлам
  • index_all — Переиндексировать всю базу; в PRIZMA/SLOI с with_embeddings=true также обновляет эмбеддинги файлов/чанков
  • embed — Получить вектор для текста в PRIZMA/SLOI
  • chunk_text — Разрезать Markdown-текст на стабильные чанки в PRIZMA/SLOI
  • chunk_file — Разрезать тело одной заметки на стабильные чанки в PRIZMA/SLOI

What it needs from you

Configuration is passed through the environment: OBSIDIAN_ROOT, NOUZ_CONFIG, EMBED_API_URL, NOUZ_DATABASE_PATH, EMBED_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Nouz MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Nouz MCP's toolset — sign, suggest_metadata, write_file and 11 more — is a fair guide to whether it matches your workflow. It is maintained by semiotronika; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Nouz MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
signS
suggest_metadataЗнак, уровень, мосты, дрифт-предупреждения
write_fileЗаписать заметку с YAML-разметкой
update_metadataОбновить только YAML, не меняя текст заметки
read_fileПрочитать заметку + метаданные
calibrate_coresОбновить векторы-эталоны ядер
recalc_signsПересчитать знаки всех заметок
recalc_core_mixПересчитать доменный профиль родителей по дочерним содержательным узлам
index_allПереиндексировать всю базу; в PRIZMA/SLOI с with_embeddings=true также обновляет эмбеддинги файлов/чанков
embedПолучить вектор для текста в PRIZMA/SLOI
chunk_textРазрезать Markdown-текст на стабильные чанки в PRIZMA/SLOI
chunk_fileРазрезать тело одной заметки на стабильные чанки в PRIZMA/SLOI
search_chunksИскать по сохранённым chunk embeddings в PRIZMA/SLOI; по умолчанию снижает анизотропию
list_filesСписок с фильтрами по уровню, знаку

How to install the Nouz MCP MCP server

{
  "mcpServers": {
    "nouz": {
      "command": "uvx",
      "args": ["nouz-mcp"],
      "env": {
        "OBSIDIAN_ROOT": "your-value",
        "NOUZ_CONFIG": "your-value",
        "EMBED_API_URL": "your-value",
        "NOUZ_DATABASE_PATH": "your-value",
        "EMBED_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OBSIDIAN_ROOTConfiguration value read at startup.Optional
NOUZ_CONFIGConfiguration value read at startup.Optional
EMBED_API_URLEndpoint or connection string the server talks to.Yes
NOUZ_DATABASE_PATHFilesystem location the server is allowed to use.Optional
EMBED_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Nouz MCP to sign.
  • Use Nouz MCP to suggest metadata.
  • Use Nouz MCP to write file.

Frequently asked questions

It connects Nouz MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (sign, suggest_metadata, write_file, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Nouz MCP directly.