obsidian-sync-mcp

MCP-сервер (streamable HTTP) над репликой Obsidian-волта (/srv/vault, Syncthing) с CAS-записью.

Инструменты

• list_notes(dir?) — рекурсивный список .md (скрыты .git, .stversions, .stfolder, .trash)

• read_note(path) → { content, rev }, rev = sha256(content)[:12]

• write_note(path, content, base_rev?) — CAS: файл существует → base_rev обязателен, не совпал → CONFLICT + свежие { content, rev }; файла нет → создание без base_rev

• patch_note(path, old_str, new_str) — old_str ровно один раз, иначе ошибка + свежие { content, rev }

• search_notes(query, dir?) — ripgrep, путь + номер строки + строка

Related MCP server: obsidian-mcp

Гарантии

• Мьютекс на путь: записи в один файл сериализуются

• Atomic write: tmp в той же директории (.syncthing.* — Syncthing игнорирует) + rename

• Path traversal: resolve + проверка префикса волта; запись в .git, .stversions, .stfolder, .obsidian запрещена

• Auth: Bearer-токен (env AUTH_TOKEN), иначе 401

Деплой

/opt/obsidian-sync-mcp        код (git clone + npm install --omit=dev)
/etc/obsidian-sync-mcp/env    AUTH_TOKEN=... VAULT_DIR=/srv/vault PORT=8787
deploy/obsidian-sync-mcp.service → /etc/systemd/system/

Наружу — через cloudflared tunnel: https://obsidian-mcp.example.com/mcp → localhost:8787.

claude mcp add --transport http vault https://obsidian-mcp.example.com/mcp --header "Authorization: Bearer <токен>"