rps321321/obsidian-mcp-pro

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Запускает фильтры 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. Неподдерживаемые условия выводятся как предупреждения и считаются несовпадением.

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

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

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

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

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

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

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

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

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

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

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