rps321321/obsidian-mcp-pro

Add Canvas Edge

Создает направленное ребро, соединяющее два существующих узла на холсте. Оба узла — fromNode и toNode — уже должны быть на холсте (используй read_canvas, чтобы получить список ID узлов, или запомни ID, который вернул add_canvas_node). Опциональные fromSide/toSide задают, к какой стороне каждого узла привязывается ребро. Возвращает сгенерированный UUID ребра.

Add Canvas Node

Добавляет новый узел в холст Obsidian и сохраняет обновлённый файл. Поддерживает четыре типа узлов: 'text' (блок Markdown), 'file' (встроенная ссылка на заметку в хранилище), 'link' (внешняя ссылка) и 'group' (контейнер с подписью). Возвращает сгенерированный UUID узла, необходимый для соединения узлов через add_canvas_edge. Если не указаны ни x, ни y, новый узел автоматически размещается в позиции (50 * количество_существующих, 50 * количество_существующих), чтобы избежать наложения узлов с позицией по умолчанию в начале координат. Явное указание x или y всегда отменяет это смещение.

Append to Note

Добавляет текст в конец существующей заметки, не меняя предыдущее содержимое. По умолчанию вставляет перенос строки в начале, если файл ещё не заканчивается на него, чтобы добавляемый контент шёл с новой строки. Используйте для логов, текущих списков или добавления новых разделов. Завершается ошибкой, если заметка не существует — сначала создайте новую заметку через create_note.

Create Daily Note

Создаёт ежедневную заметку для сегодняшнего дня (или указанной даты) в настроенной папке для ежедневных заметок хранилища, используя настроенный формат имени файла. При необходимости можно заполнить заметку из файла шаблона с подстановкой плейсхолдеров в стиле Obsidian: {{date}} и {{title}} → отформатированная дата; {{time}} → местное время в формате HH:mm; {{date:FORMAT}} / {{time:FORMAT}} → пользовательский формат в стиле moment. Завершается ошибкой, если ежедневная заметка уже существует.

Create Note

Создаёт новую заметку в формате Markdown по указанному пути с содержимым тела и опциональным YAML-заголовком. Завершается ошибкой (не перезаписывает), если заметка уже существует по этому пути — для существующих заметок используйте append_to_note, prepend_to_note или update_frontmatter. Отсутствующие директории создаются автоматически, а расширение .md добавляется, если опущено.

Delete Note

Удаляет заметку. По умолчанию файл перемещается в папку .trash хранилища (можно восстановить внутри Obsidian); передайте permanent=true, чтобы сразу удалить его с диска. Если permanent=true, вы также можете передать removeReferences=true, чтобы удалить вики-ссылки и markdown-ссылки на удалённый файл по всему хранилищу (вставки удаляются полностью; обычные ссылки заменяются на их видимый текст). Ссылки никогда не перезаписываются при перемещении файла в .trash, так как удалённые файлы можно восстановить.

Edit Block

Заменяет содержимое блока, помеченного `^id`. Конечная метка `^id` сохраняется в последней строке нового содержимого, чтобы существующие включения (`![[note#^id]]`) продолжали работать. Используйте для обновления одного абзаца или элемента списка, на которые ссылаются другие заметки.

Find Broken Links

Проверяет заметки на наличие вики-ссылок ([[цель]]), цель которых не ведёт к существующей заметке в хранилище. Показывает отчёт с группировкой по источнику: для каждой заметки указан текст битой ссылки и номера строк, а также общее количество. Используйте после переименования, перемещения или удаления заметок, чтобы выявить оборванные ссылки. При разрешении ссылок проверяется всё хранилище, даже если анализ ограничен одной папкой, поэтому сообщается только о ссылках, которые действительно не удаётся разрешить.

Find Orphan Notes

Определяет изолированные заметки в графе связей хранилища, разделённые на три группы: полностью изолированные (нет ни входящих, ни исходящих ссылок), без обратных ссылок (на них никто не ссылается) и без исходящих ссылок (они ни на кого не ссылаются). Возвращает количество заметок по каждой категории и примеры для каждой, ограничиваясь параметром maxResults. Помогает выявить заброшенные заметки, недостающие страницы-хабы или кандидаты на архивирование.

Find Similar Notes

По заданному пути заметки верните K наиболее семантически похожих заметок из индекса (исключая исходную заметку). Использует существующие эмбеддинги чанков исходной заметки и привязывает исходный запрос к чанкам, соответствующим начальной теме заметки, без вызова API к провайдеру эмбеддингов, поэтому это быстро и бесплатно. Сначала запустите `index_vault`, чтобы заполнить эмбеддинги для исходной заметки и кандидатов.

Find Unused Attachments

Находит вложения, на которые не ссылается ни одна заметка — ни через вставки `![[file]]`, ни через markdown-ссылки `[text](file)`. Полезно для гигиены хранилища перед архивацией или синхронизацией. Объединяйте вывод с операциями `delete` из вашей оболочки, так как этот инструмент намеренно не удаляет файлы.

Get Attachment

Читает файл вложения и возвращает его байты клиенту. Изображения возвращаются как блоки содержимого `image` (отображаются внутри строки Claude / Cursor), аудио — как блоки `audio`, всё остальное — как блок `resource` в base64 с URI vault://. По умолчанию ограничение 5 МБ, чтобы не тратить токены впустую; можно увеличить через `maxBytes` до 50 МБ. Вложение должно находиться внутри хранилища: заметки markdown (.md), канвасы (.canvas) и Bases (.base) намеренно отклоняются, чтобы вызывающие случайно не вытянули текстовые файлы через этот бинарный путь; используйте get_note / read_canvas / read_base.

Get Backlinks

Выводит список всех заметок, содержащих вики-ссылку на указанную заметку. Каждый результат включает путь к исходной заметке, номер строки и окружающий текст строки для контекста. Используйте, чтобы понять, какие заметки ссылаются на тему, или оценить последствия переименования или удаления заметки. Принимает пути с расширением .md и без него; если точное совпадение не найдено, выполняет поиск по базовому имени.

Get Daily Note

Читает ежедневную заметку за сегодня или за указанную дату, определяя её по настроенным в хранилище папке и формату имени файла. Возвращает путь к заметке, разобранный frontmatter (как блок с заголовками) и тело. Выдаёт ошибку, если ежедневной заметки на эту дату нет — используй create_daily_note, чтобы её создать.

Get Graph Neighbors

Обходит граф вики-ссылок наружу от начальной заметки и возвращает все заметки, достижимые в пределах N переходов, сгруппированные по уровню глубины, с визуализацией в виде вложенного дерева. Каждый сосед помечается расстоянием в переходах и направлением (inbound — достигнут через обратную ссылку, outbound — достигнут через прямую ссылку). Используется для исследования тематического кластера, построения карты локального окружения заметки или поиска связанных заметок за пределами прямых ссылок. Принимает пути с расширением .md и без него.

Get Note

Читает заметку целиком или фрагментом. Без опций фрагмента возвращает разобранный frontmatter (в виде помеченного заголовка), плоский список inline-тегов # и тело заметки. С опцией `section` возвращает только тело под этим заголовком (поддерживается путь вида 'Tasks/Today'). С опцией `block` возвращает абзац или блок с тегом `^id`. С опцией `lines` возвращает диапазон строк включительно с индексацией от 1. Режимы фрагмента пропускают заголовок frontmatter/тегов и возвращают сырой текст - используйте их, чтобы экономить токены на длинных заметках.

Get Outlinks

Выводит список всех исходящих wikilink из заметки, разбивая их на валидные ссылки (ведут на существующую заметку), битые ссылки (цель не найдена) и файловые вставки (![[...]]). Возвращает исходный текст ссылки и разрешённые пути. Используйте, чтобы проверить ссылки заметки, найти битые ссылки или отследить downstream-зависимости.

Get Recent Notes

Выводит заметки, отсортированные по дате последнего изменения — сначала новые. Опциональный фильтр `since` принимает дату в формате ISO (например, '2026-04-01') или относительный промежуток ('7d', '24h', '2w'); возвращаются только заметки, изменённые в указанное время или позже. Используйте, чтобы посмотреть, над чем вы работали, собрать дайджест «что изменилось на этой неделе» или выбрать заметки для повторения.

Get Vault Stats

Возвращает быстрый снимок состояния хранилища: количество заметок, общее количество байт, общее количество слов, количество уникальных тегов, количество заметок без тегов и самую недавно изменённую заметку. Полезно для дашбордов и проверок 'здорово ли это хранилище?'. Читает через кеш mtime, поэтому повторные вызовы дёшевы.

Index Vault for Semantic Search

Строит или обновляет индекс эмбеддингов, используемый `search_semantic` и `find_similar_notes`. Разбивает читаемые заметки на фрагменты с учётом заголовков, отправляет эти фрагменты настроенному провайдеру эмбеддингов (по умолчанию Ollama, OpenAI опционально) и сохраняет индекс в `<хранилище>/.obsidian/cache/mcp-pro-embeddings.json`. Требует `confirm: "send-vault-text-to-embedding-provider"`, чтобы вызывающие явно подтверждали, что текст из хранилища покинет границы этого инструмента. Инкрементально: заметки, чей хеш содержимого совпадает с предыдущим проходом, пропускаются. Используйте `force: true`, чтобы перестроить все эмбеддинги (например, после смены моделей). Отправляет уведомления о прогрессе, если клиент подписался.

Insert at Section

Вставляет содержимое в конкретный раздел, не заменяя его. `position` определяет, куда вставлять: 'before' - перед заголовком, 'after-heading' - сразу под строкой заголовка (в начало тела раздела), 'append' - в конец тела раздела, перед следующим заголовком. Используйте, чтобы добавить новый пункт или абзац без переписывания раздела.

List Attachments

Перечислить все файлы в хранилище, не являющиеся markdown: изображения, PDF, аудио/видеоклипы, любые вставленные файлы помимо заметок/канвасов/Bases. Возвращает отсортированный список относительных путей и сводку количества по расширениям. Используйте для аудита активов, поиска дубликатов по имени или выбора целей для find_unused_attachments.

List Bases

Перечисляет все файлы Obsidian Bases (.base) в хранилище. Bases: YAML-определённые представления базы данных над заметками (фильтры, свойства, табличные/календарные/канбан-представления). Возвращает отсортированный список относительных путей и общее количество. Используется вместе с read_base или query_base.

List Canvases

Перечисляет все файлы холстов Obsidian (.canvas) в любом месте хранилища, возвращая нумерованный список относительных путей и общее количество. Не принимает параметров — сканирует всё хранилище. Используйте для обнаружения доступных холстов перед вызовом read_canvas, add_canvas_node или add_canvas_edge.

List Notes

Перечисляет все заметки Markdown в хранилище (или отдельной папке), возвращая отсортированный список относительных путей вместе с общим количеством. Урезает вывод до `limit` записей, но всё равно сообщает общее число. Используйте для просмотра структуры хранилища, создания файлового пикера или перечисления целей для пакетной обработки.

List Sections

Выводит все заголовки в заметке в виде дерева путей (с указанием глубины). Полезно для поиска допустимых значений аргумента `section` перед вызовом get_note, update_section или insert_at_section.

List All Tags

Перечисляет все уникальные теги, используемые в хранилище, и количество заметок, в которых встречается каждый тег. Распознаёт теги как из инлайн #хэштегов, так и из YAML фронтматера, нормализует их без учёта регистра, возвращает отсортированный список и общее количество уникальных тегов. Используйте для построения облака тегов, выбора категорий, аудита таксономии или обнаружения доступных тегов перед вызовом search_by_tag.

Move/Rename Note

Перемещает или переименовывает заметку в хранилище, полностью сохраняя её содержимое. Родительские папки по пути назначения создаются при необходимости. По умолчанию обновляет вики-ссылки и ссылки на файлы — так же, как в Obsidian при включённой опции «Автоматически обновлять внутренние ссылки»; для этой перезаписи требуется, чтобы `confirmPath` совпадал с путём назначения после нормализации .md. Укажите `updateLinks: false`, чтобы пропустить перезапись (быстрее в больших хранилищах; если нужно потом проверить — используйте `find_broken_links`). Расширение .md добавляется автоматически, если его нет ни в одном из путей.

Prepend to Note

Вставляет содержимое в начало тела существующей заметки, сразу после блока YAML frontmatter, если он есть (чтобы метаданные оставались в начале файла). Используйте для добавления новых элементов в начало списка, закрепления контекста или вставки разделов TL;DR. Завершается ошибкой, если заметка не существует.

Query Base

Запускает фильтры Base-файла по хранилищу и возвращает пути совпадающих заметок. Опционально можно выбрать именованное представление, чтобы применить фильтры и порядок этого представления поверх фильтров базового уровня. Поддерживаемый синтаксис фильтров (подмножество полного DSL Obsidian): цепочки методов `file.hasTag("tag")`, `file.hasProperty("key")`, `file.inFolder("path")`, `file.linksTo("target")`, `file.name.contains("x")`/`.startsWith`/`.endsWith`/`.equals`, плюс `.isEmpty`/`.isNotEmpty` для любого значения; устаревшая форма функции `taggedWith(file, "tag")`; сравнения `key == "val"`, `key != x`, `key contains x`, `>=`, `<=`, `>`, `<`; комбинаторы `and:`, `or:`, `not:`. Распознаваемые свойства файла: file.name, file.basename, file.folder, file.ext, file.path, file.size, file.ctime, file.mtime, file.tags, file.properties, file.links, file.embeds, file.backlinks. Неподдерживаемые условия выводятся как предупреждения и считаются несовпадением.

Read Base

Возвращает разобранное содержимое файла Base: фильтры, свойства, определения представлений и любые нераспознанные поля. Используется для выяснения того, какие запросы поддерживает Base, перед вызовом query_base.

Read Canvas

Читает файл Obsidian canvas (.canvas, формат JSON) и возвращает краткое человекочитаемое описание его структуры: общее количество узлов и связей, до 200 узлов с id/типом/позицией/размером/превью содержимого и до 200 связей с id исходного и целевого узлов, плюс необязательная метка. Используйте для просмотра или навигации по canvas перед вызовом add_canvas_node или add_canvas_edge.

Rename Tag

Переименовывает тег везде, где он встречается в хранилище — и в инлайн-тегах `#тег`, и в полях `tags:` в frontmatter. Для записи (не сухой прогон) требуется, чтобы `confirmTag` совпадал с новым именем тега. Если `hierarchical: true` (по умолчанию), вложенные теги тоже перебазируются: переименование `project` в `client` также переименует `project/alpha` → `client/alpha`. Если `dryRun: true`, возвращает планируемое количество изменений без записи. Отбрасывайте ведущий `#` у oldName/newName — это имена тегов, а не токены тегов.

Replace in Note

Поиск и замена в пределах одной заметки. Поддерживает буквальные строки или регулярные выражения. С параметром `expectedCount` операция отказывается выполняться, пока не найдено указанное количество совпадений — это защищает от случайной перезамены, когда LLM составляет слишком широкий шаблон. Возвращает количество сделанных замен.

Resolve Alias

Ищет все заметки, у которых в frontmatter поле `aliases:` содержит указанное имя (без учёта регистра). При `includeBasename: true` также находит заметки, чьё имя файла (без `.md`) совпадает с именем: это запасной вариант разрешения в Obsidian, когда ни один псевдоним не совпадает. Используйте, чтобы преобразовать человекочитаемый заголовок, например 'My Project', в реальный путь к заметке перед вызовом get_note.

Search by Frontmatter

Находит заметки, в YAML frontmatter которых содержится заданная пара свойство/значение. Имена свойств и значения сравниваются без учёта регистра; для свойств-массивов совпадение засчитывается, если совпадает хотя бы один элемент. Возвращает пути к подходящим заметкам вместе с их полным frontmatter. Используйте для фильтрации заметок по метаданным в frontmatter — статусу, типу, тегам и т.п.

Search by Tag

Находит все заметки, отмеченные определённым тегом, включая вложенные подтеги (поиск 'project' находит и #project, и #project/alpha). Распознаёт теги как в инлайн-хэштегах, так и в YAML frontmatter. Возвращает пути к найденным заметкам с опциональным предпросмотром содержимого. Используйте для сбора заметок по теме, области или этапу рабочего процесса.

Search Notes

Полнотекстовый поиск по всем заметкам в хранилище. Ранжирует точные совпадения с фокусом на заголовке/пути и подавлением повторяющихся строк, затем возвращает пути совпавших заметок, сгруппированные с номерами строк и содержимым сниппета вокруг запроса для каждой совпавшей строки. Используйте для поиска заметок, содержащих фразу, ключевое слово или фрагмент кода; используйте вместе с get_note для получения полного текста.

Semantic Search

Ищет заметки по смыслу, а не по ключевым словам. Встраивает запрос с помощью настроенного провайдера, оценивает каждый фрагмент в сохранённом индексе по косинусному сходству, ранжирует по одному результату на заметку, используя лучший фрагмент плюс небольшой сигнал фокуса на верхнем фрагменте, и возвращает лучший фрагмент как источник отрывка. Сначала выполните `index_vault`, чтобы заполнить индекс — этот инструмент не индексирует автоматически, потому что пользователь должен знать, что оплачивает стоимость встраивания. Используйте вместе с `get_note`, чтобы получить полный текст заметки после выбора совпадения.

Update Frontmatter

Добавляет новые пары ключ-значение в YAML-шапку заметки, сохраняя все неупомянутые ключи и не трогая содержимое тела. Ключи из payload перезаписывают существующие значения. Создаёт блок шапки, если у заметки его нет. Возвращает количество записанных свойств. Используйте, чтобы задавать поля статуса, массивы тегов или другие метаданные без перезаписи тела. Примечание: YAML-блок пересоздаётся при каждом обновлении — комментарии, пользовательские кавычки, стиль многострочных скаляров, пустые строки и порядок ключей внутри блока нормализуются. Наличие *ключей и значения* сохраняются; форматирование — нет.

Update Section

Заменяет тело указанной секции (всё между заголовком и следующим заголовком любого уровня). Строка заголовка сохраняется. `section` — это путь к заголовку: `'Tasks'`, `'Project A/Status'` и т.д. — без учёта регистра и пробелов. Используйте это вместо перезаписи всего файла, когда нужно обновить только одну секцию.