[2026-06-25] taiga-vault: family/how-to/htpc-emulators-setup.md family/how-to/htpc-gaming-plans.md family/how-to/kraken-access.md family/how-to/openmediavault-rpi5.md family/how-to/time-machine.md family/how-to/wireguard-vpn.md personal/documents/todo-list.md personal/plans/extract-stable-prompt-blocks.md personal/plans/hermes-whale-system-prompt.md personal/plans/thread-scoped-memory.md

2026-06-25 05:23:46 +00:00
parent ac0d753ec0
commit 16987d69f3
26 changed files with 2656 additions and 457 deletions
@@ -0,0 +1,104 @@
+# Obsidian MCP implementation ecosystem (2026)
+
+Обзор активных реализаций Obsidian MCP серверов по состоянию на июнь 2026. Три архитектурных подхода, ~8 проектов с traction.
+
+## Три архитектуры
+
+| Подход | Примеры | Obsidian нужен? | Плюсы | Минусы |
+|--------|---------|----------------|-------|--------|
+| **Direct filesystem** | mcpvault, obsidian-mcp (Steven) | Нет | Простота, работает без Obsidian | Нет доступа к внутреннему API Obsidian |
+| **Local REST API plugin** | mcp-obsidian (Markus), cyanheads | Да (должен быть открыт) | Obsidian опосредует операции | Нужен плагин + API key |
+| **Native Obsidian plugin** | obsidian-mcp-plugin (aaronsb) | Да (должен быть открыт) | Полный API: граф, Dataview, Bases | Менее зрелый, только через BRAT |
+
+## Детальный обзор
+
+### 1. @bitbonsai/mcpvault (наш текущий) — filesystem
+
+- **npm:** `@bitbonsai/mcpvault` (бывший `obsidian-mcp`, переименован март 2026 из-за trademark)
+- **Версия:** 0.12.1 (июнь 2026)
+- **Язык:** TypeScript
+- **Транспорт:** stdio только
+- **Инструменты:** 14: read_note, write_note, patch_note, list_directory, delete_note, search_notes, move_note, move_file, read_multiple_notes, update_frontmatter, get_notes_info, get_frontmatter, manage_tags, get_vault_stats, list_all_tags
+- **Проблема:** exact string match в patch_note (`fullContent.split(oldString).length - 1`), без fuzzy, без trim, без нормализации whitespace
+
+### 2. cyanheads/obsidian-mcp-server — REST API, самый популярный по загрузкам
+
+- **npm:** `obsidian-mcp-server`
+- **Версия:** 3.2.8 (май 2026)
+- **★:** 603 | **dl/week:** ~9,776 (самые высокие)
+- **Язык:** TypeScript, Bun/Node.js v24+
+- **Транспорт:** stdio + Streamable HTTP (dual)
+- **Инструменты:** 14
+- **Требует:** Obsidian Local REST API plugin v4.0.0+
+- **Ключевые фичи:**
+  - `obsidian_replace_in_note` — regex, whole-word, flexible whitespace, case-sensitivity, capture groups. **Решает проблему exact match**.
+  - `obsidian_patch_note` — surgical append/prepend/replace по heading/block/frontmatter
+  - Path policy (folder-scoped permissions через env vars: OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS)
+  - In-memory vault cache (configurable, default 10 min)
+  - JWT/OAuth аутентификация
+  - Structured logging с file rotation
+  - Zod schema validation
+  - Docker support (`ghcr.io/cyanheads/obsidian-mcp-server`)
+- **Вердикт:** самый production-ready
+
+### 3. MarkusPfundstein/mcp-obsidian — REST API, Python
+
+- **npm:** `mcp-obsidian` (Python, через uvx)
+- **★:** ~3,700 (самые звёзды)
+- **Язык:** Python 100%
+- **Транспорт:** stdio
+- **Статус:** был 17 месяцев мёртв, вернулся 15 мая 2026. Но npm всё ещё v1.0.0.
+- **Инструменты:** 7 (list_files, get_file_contents, search, patch_content, append_content, delete_file)
+- **Известные баги:** patch_content timeout/validation (#9), UTF-8 failures (#25), Dataview dependency (#70), нет multi-vault (#63)
+- **Вердикт:** watch — viable если выйдет новый npm release
+
+### 4. aaronsb/obsidian-mcp-plugin (Semantic Notes Vault MCP) — native plugin
+
+- **★:** 423
+- **Версия:** 0.11.33 (13 релизов с 20 апреля, очень активен)
+- **Язык:** TypeScript (плагин Obsidian)
+- **Транспорт:** HTTP (порт 3001/3443)
+- **Инструменты:** 8 категорий (vault, edit, view, graph, workflow, dataview, bases, system)
+- **Ключевые фичи:**
+  - **Fuzzy text matching** для edits — прямо в описании
+  - Graph traversal (multi-hop, backlinks, forward-links, path finding)
+  - Dataview DQL execution
+  - Bases database operations
+  - Read-only mode
+  - mcpb one-click install для Claude Desktop
+- **Минус:** Obsidian должен быть открыт. Установка через BRAT (не в community store).
+- **Вердикт:** если нужен graph/Dataview/Bases — лучший выбор
+
+### 5. Local REST API v4.0.0+ built-in MCP
+
+- **Плагин:** `coddingtonbear/obsidian-local-rest-api` (★ 2.5k)
+- **Версия:** v4.1.3 (июнь 2026)
+- С апреля 2026: Local REST API сам стал MCP сервером на `/mcp/`
+- **15 tools** (file CRUD, search, tagging, commands, open-in-ui)
+- **Транспорт:** Streamable HTTP
+- **Требует:** только установку плагина + API key (никаких дополнительных пакетов)
+
+### 6. Minhao-Zhang/obsidian-mcp-server — WIP plugin
+
+- **★:** 13
+- **Версия:** v1.1.0 (апрель 2025 — заброшен)
+- **Статус:** WIP. Автор: «я не знаю TypeScript». Не рекомендуется.
+
+## Остальные
+
+Всего ~79 Obsidian-связанных MCP серверов на PulseMCP, но ~8 имеют traction. Большинство — клоны/форки mcpvault или mcp-obsidian.
+
+## Рекомендация от 2026-06-24
+
+**Лучший апгрейд без смены архитектуры — cyanheads/obsidian-mcp-server.**
+
+Почему:
+1. Решает exact match проблему — `obsidian_replace_in_note` с regex и flexible whitespace
+2. Самая высокая загрузка (9.7K dl/week) — стабильность доказана
+3. Dual transport (можно через stdio как Hermes native MCP, можно HTTP)
+4. Path policy — можно ограничить запись только определёнными папками
+5. Docker support
+
+Минус: требует Obsidian открытым (Local REST API плагин).
+
+**Если не хочется ставить плагин:** остаться на mcpvault + Hermes `patch()` для сложных строк.