mcp-obsidian-cli

mcp-obsidian-cli

stonemattMIT
1 звёзд
Сервер mcp-obsidian-cli соединяет Claude Desktop с вашим хранилищем Obsidian. Вы работаете в чате с ИИ: обсуждаете идеи, пишете код, спорите с моделью. Когда результат нужно сохранить — просто просите ассистента положить заметку в нужное место. Не нужно переключать окна и копировать текст вручную. MCP-сервер перехватывает запрос, обращается к Obsidian через его встроенный CLI и создаёт заметку с разметкой, ссылками и метаданными. Obsidian может быть свёрнут, но должен быть запущен с включённым CLI — это главное техническое условие.
CommunicationObsidian
Открыть на GitHub

Установка

npx -y mcp-obsidian-cli

Характеристики

Общее

  • СтатусСообщество
  • Разработчикstonematt
  • ЛицензияMIT

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Сохранять историю диалогов из Claude Desktop в виде структурированных заметок.
  • Создавать заметки на основе заранее заготовленных шаблонов в указанной папке.
  • Автоматически проставлять метаданные (свойства, теги, дату) в новой заметке.
  • Добавлять запись в ежедневную заметку (daily note) без лишних телодвижений.
  • Искать по всему тексту в хранилище и возвращать релевантные фрагменты в диалог.
  • Получать обратные ссылки (backlinks) для выбранной заметки прямо в чат.
  • Обновлять существующие заметки — добавлять текст, ссылки, теги.
  • Выполнять любую из более чем 80 встроенных команд CLI Obsidian через универсальный инструмент.

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

Шаг 1. Включите интерфейс командной строки в Obsidian: «Настройки» → «Основные» → «Дополнительно» → «Интерфейс командной строки».

Шаг 2. Установите сервер глобально через npm:

npx -y mcp-obsidian-cli

Шаг 3. Настройте подключение в вашем MCP-клиенте. Для Claude Desktop добавьте запись в файл конфигурации:

{ "mcpServers": { "obsidian": { "command": "npx", "args": ["-y", "mcp-obsidian-cli"], "env": { "OBSIDIAN_VAULT": "my-vault" } } } }

Шаг 4. Убедитесь, что Obsidian запущен. На macOS сервер автоматически найдёт CLI по пути /Applications/Obsidian.app/Contents/MacOS/obsidian-cli. Если Obsidian установлен по-другому, укажите путь в переменной OBSIDIAN_CLI_PATH.

Шаг 5. Перезапустите Claude Desktop. Сервер готов к работе. Протестируйте его простой командой: «создай заметку с текстом "Hello World" в моём хранилище».

Примеры запросов

«Сохрани этот план статьи в хранилище Research, папка Projects, используй шаблон "Стандартная заметка".»

«Найди в хранилище все заметки по архитектуре MCP, покажи их заголовки и первые строки содержимого.»

«Добавь запись в мою ежедневную заметку: "Сегодня настроил mcp-obsidian-cli". Используй стандартный шаблон для логов.»

«Достань обратные ссылки для заметки "Quarterly Goals" из папки Management.»

Технические детали

Язык разработки: JavaScript (Node.js v18 и выше). Транспорт: stdio. Лицензия: MIT.

Для работы необходима запущенная копия Obsidian с активированным интерфейсом командной строки. Совместимые клиенты: Claude Desktop, Claude Code (есть отдельный нативный навык), а также любые MCP-хосты. Категории: Obsidian, коммуникация.

Поделиться