Obsidian·MarkusPfundstein

Obsidian MCP — подключение и инструкция

Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.

Файлы и документыЛокальноAPI-ключ

Что умеет этот сервер

01

Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.

02

Вариант MarkusPfundstein работает через community-плагин Local REST API в Obsidian.

03

Начни с поиска известной тестовой заметки и чтения её текста.

Задача для знакомства

Через Obsidian MCP найди тестовую заметку по точному названию и покажи её текст. Пока не дописывай и не удаляй файлы.

Уточнить результат

Сверь vault, путь заметки и фактическое содержимое после правки. Если поиск пустой, проверь доступность Local REST API и ключ. Ошибка пути не должна превращаться в создание случайного нового файла.

Как подключить

Выберите подходящий способ

Подключить Obsidian MCP

Установи Local REST API через Community Plugins и включи его. Добавь uvx mcp-obsidian в клиент и задай OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT. Пример записи сервера объедини с остальным mcpServers своей конфигурации.

Что понадобится

  • Obsidian с открытым vault, установленный Local REST API, ключ плагина и uv/uvx. Адрес и порт должны соответствовать реальным настройкам плагина.
  1. 01

    Подготовь окружение

    Obsidian с открытым vault, установленный Local REST API, ключ плагина и uv/uvx. Адрес и порт должны соответствовать реальным настройкам плагина.

  2. 02

    Установи и настрой

    Установи Local REST API через Community Plugins и включи его. Добавь uvx mcp-obsidian в клиент и задай OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT. Пример записи сервера объедини с остальным mcpServers своей конфигурации.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Команда сервера — env настраивается отдельно

uvx mcp-obsidian

Первый запрос — пример для чата агента

Через Obsidian MCP найди тестовую заметку по точному названию и покажи её текст. Пока не дописывай и не удаляй файлы.

Как проверить

Сверь vault, путь заметки и фактическое содержимое после правки. Если поиск пустой, проверь доступность Local REST API и ключ. Ошибка пути не должна превращаться в создание случайного нового файла.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Obsidian

Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.

Вариант MarkusPfundstein работает через community-плагин Local REST API в Obsidian. Это не прямое чтение любого vault с диска: нужны плагин, адрес и API-ключ его сервера.

Что подготовить перед подключением

Obsidian с открытым vault, установленный Local REST API, ключ плагина и uv/uvx. Адрес и порт должны соответствовать реальным настройкам плагина.

Как установить и подключить

Установи Local REST API через Community Plugins и включи его. Добавь uvx mcp-obsidian в клиент и задай OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT. Пример записи сервера объедини с остальным mcpServers своей конфигурации.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Начни с поиска известной тестовой заметки и чтения её текста. Затем добавь небольшой фрагмент под конкретный заголовок в копии заметки. Проверь markdown и ссылки в Obsidian.

Как проверить результат и решить проблемы

Сверь vault, путь заметки и фактическое содержимое после правки. Если поиск пустой, проверь доступность Local REST API и ключ. Ошибка пути не должна превращаться в создание случайного нового файла.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Возможности определяются REST-плагином и доступом к vault. Изменения могут затрагивать заметки, поэтому для первого теста не выбирай единственный экземпляр важных данных.

Исходники и документация

Репозиторий: MarkusPfundstein/mcp-obsidian. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Obsidian

Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.
Вернуться в библиотеку