obsidian-mcp

Предоставьте Claude (и любому MCP-клиенту) полноценный агентский доступ к вашему хранилищу Obsidian — обход графа, запросы Dataview, работа с ежедневными заметками и многое другое.

Установка · Инструменты · Примеры промптов · Сравнение · ЧаВо

Большинство MCP-серверов для Obsidian предоставляют только read_file и write_file, на этом их возможности заканчиваются. Этот сервер рассматривает ваше хранилище как граф знаний — ваша LLM получает доступ к обратным ссылкам, прямым ссылкам, запросам Dataview, ежедневным заметкам и многошаговому обходу графа в рамках одного вызова.

Зачем это нужно

Вы открывали Claude Desktop, просили его найти связи в заметках и наблюдали, как он по очереди «читает» файлы в вашем хранилище. Но пользователи Obsidian думают о своих заметках иначе. Граф и есть ценность — обратные ссылки, транзитивные связи, теги, метаданные Dataview. Этот сервер предоставляет всё это как инструменты первого класса.

Установка

Вам понадобится плагин Local REST API в Obsidian. Установите его из Community Plugins, включите и скопируйте API-ключ из настроек.

Claude Desktop

Добавьте это в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp"],
      "env": {
        "OBSIDIAN_API_KEY": "paste-your-key-here"
      }
    }
  }
}

Перезапустите Claude Desktop. Готово.

Claude Code

claude mcp add obsidian -e OBSIDIAN_API_KEY=paste-your-key-here -- npx -y obsidian-mcp

Cursor / Cline / Continue / Zed

Работает любой MCP-совместимый клиент. Укажите его на npx -y obsidian-mcp с переменной окружения OBSIDIAN_API_KEY.

Из исходного кода

git clone https://github.com/yanxue06/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build
OBSIDIAN_API_KEY=... node dist/index.js

Примеры промптов

Попробуйте отправить их в Claude Desktop при подключенном сервере:

Составь карту контента (MOC) для всего, что я написал о распределенных системах. Используй traverse_graph для "Distributed systems.md" с глубиной 2, затем сгруппируй соседей по темам и запиши MOC в файл MOCs/Distributed systems MOC.md.

Найди все заметки с тегом #project, где status != "done" и срок выполнения — на этой неделе. Используй query_dataview.

Что у меня в сегодняшней ежедневной заметке? Есть ли что-то, что я забыл сделать из вчерашней заметки?

Найди все мои «сиротские» заметки в папке Inbox/. Для каждой предложи место, куда её лучше поместить, основываясь на содержании и существующих тегах.

Я переименовываю "Atomic notes.md" в "Evergreen notes.md". Найди все заметки, которые ссылаются на него, и скажи, какие из них мне нужно обновить.

Пройди по графу на 2 шага от "Working memory.md" и скажи, какие заметки наиболее важны для моих размышлений о внимании.

Инструменты

Всего 15 инструментов. Уникальные выделены жирным.

Чтение

Поиск и граф

Запись

Сравнение

Конфигурация

Все настройки осуществляются через переменные окружения — укажите их в конфигурации вашего MCP-клиента.

Как это работает

┌──────────────┐     stdio (MCP)      ┌──────────────┐    HTTPS     ┌──────────────────┐
│ Claude / IDE │ ───────────────────► │ obsidian-mcp │ ───────────► │  Local REST API  │ ──► Vault
└──────────────┘                      └──────────────┘              │ (Obsidian plugin)│
                                                                    └──────────────────┘

obsidian-mcp — это тонкая прослойка над плагином Local REST API. Плагин запускает HTTPS-сервер внутри Obsidian с полным доступом к хранилищу; этот сервер адаптирует интерфейс к протоколу MCP и добавляет инструменты, учитывающие структуру графа, которые REST API Obsidian не предоставляет напрямую (обратные ссылки, многошаговый обход, поиск сирот).

Всё работает локально. Никакие данные не покидают ваш компьютер, кроме запросов, которые ваш MCP-клиент отправляет провайдеру модели — и вы это контролируете.

ЧаВо

Нужно ли устанавливать плагин для Obsidian? Да — плагин Local REST API. Это единственный разумный способ взаимодействия с запущенным хранилищем извне. После установки сам obsidian-mcp работает как отдельный процесс Node, запущенный вашим MCP-клиентом; вам не нужно устанавливать дополнительные плагины в Obsidian для этого.

Работает ли это, если Obsidian закрыт? Нет. Local REST API работает внутри Obsidian, поэтому приложение должно быть открыто.

Поддерживаются ли несколько хранилищ? Один экземпляр сервера указывает на один запущенный экземпляр Obsidian. Запустите несколько записей MCP-сервера (разные имена + разные порты), если часто переключаетесь между хранилищами.

Почему HTTPS по умолчанию с OBSIDIAN_VERIFY_TLS=false? Плагин поставляется с самоподписанным сертификатом. Трафик идет только через loopback (127.0.0.1), поэтому проверка сертификата создает лишние сложности без реального выигрыша в безопасности. Если вы заменили сертификат, установите флаг в true.

Это безопасно? MCP-сервер предоставляет модели тот же уровень доступа, который дает API-ключ. Всё, что модель готова удалить, она может удалить. Относитесь к этому как к любому агенту с доступом к записи файлов — проверяйте, что он собирается сделать, особенно перед массовыми операциями.

Дорожная карта

• [ ] Семантический поиск на основе эмбеддингов (сейчас только поиск по ключевым словам через плагин)

• [ ] Переключение рабочих областей / маршрутизация между хранилищами

• [ ] Безопасный режим «только чтение» (инструменты записи не регистрируются)

• [ ] Подписки на ресурсы (push-обновления при изменении заметок)

• [ ] Регистрация в Smithery / mcp-get

PR приветствуются. См. CONTRIBUTING.md.

Благодарности

• Local REST API от @coddingtonbear — весь этот проект является его развитием.

• Команда Model Context Protocol в Anthropic.

Лицензия

MIT — см. LICENSE.