Obsidian·MarkusPfundstein
Obsidian MCP — подключение и инструкция
Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.
Что умеет этот сервер
Obsidian MCP подключает агента к хранилищу заметок: поиск, чтение файлов и добавление или изменение текста.
Вариант MarkusPfundstein работает через community-плагин Local REST API в Obsidian.
Начни с поиска известной тестовой заметки и чтения её текста.
Задача для знакомства
Через 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. Адрес и порт должны соответствовать реальным настройкам плагина.
- 01
Подготовь окружение
Obsidian с открытым vault, установленный Local REST API, ключ плагина и uv/uvx. Адрес и порт должны соответствовать реальным настройкам плагина.
- 02
Установи и настрой
Установи Local REST API через Community Plugins и включи его. Добавь uvx mcp-obsidian в клиент и задай OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT. Пример записи сервера объедини с остальным mcpServers своей конфигурации.
- 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-серверов Нейролюба.