obsidian-sync-mcp

obsidian-sync-mcp

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

Установка

npx -y obsidian-sync-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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).

Поделиться