obsidian-sync-mcp

obsidian-sync-mcp

es617v0.12.1MIT
75 звёзд31 форков
MCP-сервер, который подключает AI-агентов к вашему хранилищу Obsidian. Работает в двух режимах: Filesystem (читает .md-файлы напрямую с диска) и CouchDB (читает данные из базы, куда Obsidian синхронизирует заметки через плагин Self-hosted LiveSync). Во втором режиме сервер можно развернуть в облаке — доступ к заметкам сохранится, даже когда локальный Obsidian выключен. Подойдёт разработчикам и пользователям, которые хотят дать агенту (Claude, Copilot, кастомному ассистенту) контекст из своих заметок. База заметок становится источником знаний для AI.
  • Сервер сообщества
  • Удалённый сервер (по URL)
  • TypeScript
  • Лицензия MIT
  • Обновлён 15 ноября 2026 г.
Подключение

Подключить 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 проекта, замените шаблонные токены и предоставьте только необходимые права доступа.

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

Общее

  • СтатусСообщество
  • Разработчикes617
  • Версияv0.12.1
  • ЛицензияMIT
  • Последний релиз15.11.2026
  • Активность источника15.11.2026

Технологии

  • Языки
    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).

Поделиться