Obsidian Sync MCP

Obsidian Sync MCP

es617MIT
20 звёзд6 форков
MCP-сервер, который подключает AI-агентов к вашему хранилищу Obsidian. Работает в двух режимах: Filesystem (читает .md-файлы напрямую с диска) и CouchDB (читает данные из базы, куда Obsidian синхронизирует заметки через плагин Self-hosted LiveSync). Во втором режиме сервер можно развернуть в облаке — доступ к заметкам сохранится, даже когда локальный Obsidian выключен. Подойдёт разработчикам и пользователям, которые хотят дать агенту (Claude, Copilot, кастомному ассистенту) контекст из своих заметок. База заметок становится источником знаний для AI.
AI и машинное обучениеObsidian
Подключить MCPОткрыть на GitHub
Подключение

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

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

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "obsidian-sync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-sync-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Obsidian Sync MCP

Obsidian Sync MCP относится к AI и машинное обучение, Obsidian. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
TypeScript
Транспорт
streamable-http

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

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

Технологии

  • Языки
    TypeScript
  • Транспорт
    streamable-http

Описание

Возможности

  • Чтение заметок из Obsidian: поиск по ID, заголовку, папке, дате.
  • Полнотекстовый поиск по содержимому всех заметок.
  • Поддержка E2E-шифрования: расшифровка заметок на лету, если включено шифрование в LiveSync.
  • Работа без базы данных: локальный режим читает файлы из папки хранилища.
  • Облачная синхронизация: доступ к заметкам с любого устройства, даже без запущенного Obsidian.
  • Аутентификация через токен: защита облачного эндпоинта от посторонних.
  • Развёртывание через npx или Docker: одна команда для локального запуска, контейнер для продакшена.
  • Автоматическая сборка чанков заметок (chunk handling) в режиме CouchDB.
  • Совместимость со всеми MCP-клиентами, поддерживающими transport streamable-http.

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

Установите сервер через npx:

npx -y obsidian-sync-mcp

Добавьте конфигурацию для Claude Desktop (локальный режим с файлами):

{ "mcpServers": { "obsidian-sync-mcp": { "command": "npx", "args": ["-y", "obsidian-sync-mcp"], "env": { "MCP_MODE": "filesystem", "VAULT_PATH": "/Users/username/MyVault" } } } }

Для облачного режима укажите параметры CouchDB, токен и адрес сервера:

docker run -p 8787:8787 \ -e COUCHDB_URL=https://your-couchdb:5984 \ -e COUCHDB_DATABASE=obsidian \ -e VAULT_NAME=MyVault \ -e MCP_AUTH_TOKEN=yourpassword \ ghcr.io/es617/obsidian-sync-mcp:latest

После настройки перезапустите клиент Claude Desktop или подключите другого MCP-агента.

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

  • «Найди все заметки про развёртывание Kubernetes и выведи заголовки.»
  • «Покажи содержимое заметки за сегодня: Ежедневник 2024-10-27.»
  • «Выпиши из моей папки Meetings все задачи, помеченные как важные.»
  • «Напиши краткое изложение по заметке "Архитектура проекта" из папки Docs.»

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

  • Язык: TypeScript (Node.js 22 и выше).
  • Транспорт: streamable-http.
  • Лицензия: MIT.
  • Совместимые клиенты: Claude Desktop, GitHub Copilot, кастомные MCP-агенты.
  • Режимы: Filesystem (локально), CouchDB (локально или облако через LiveSync).

Поделиться