[2026-09-26] eagle: personal/plans/balda-mm-phase4-agents.md personal/plans/tagwriter-container.md personal/projects/personal-os/obsidian-mcp-setup.md personal/tech/balda-executor-mcp.md personal/tech/obsidian-mcp-ecosystem.md

This commit is contained in:
Alexey Martemyanov committed 2026-09-26 21:37:37 +06:00
1 parent 9e7a888f94
commit 270c4b7c52
5 files changed
+326 -11

No files matched your search

+27 -2
View File
@@ -15,12 +15,37 @@
### 1. @bitbonsai/mcpvault (наш текущий) — filesystem
- **npm:** `@bitbonsai/mcpvault` (бывший `obsidian-mcp`, переименован март 2026 из-за trademark)
- **Версия:** 0.12.1 (июнь 2026)
- **Версия:** 0.12.1 (июнь 2026); на Kraken стоит **0.11.0**
- **Язык:** TypeScript
- **Транспорт:** stdio только
- **Транспорт:** **stdio только** — HTTP-режима нет (проверено: `mcpvault --help`
принимает единственный аргумент `[vault-path]`, флагов порта/хоста не существует)
- **Инструменты:** 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
#### Как отдать mcpvault по сети (проверено на Mac и Kraken)
Поскольку HTTP-режима нет, для сетевого доступа нужна обёртка **`mcp-proxy`**
(пакет `mcp-proxy@6.4.4`), которая поднимает SSE поверх stdio-сервера:
```yaml
# docker-compose.yml — рабочая пара
services:
obsidian-mcp:
image: obsidian-mcp-image:0.1.0 # node:24-bookworm + оба пакета
command: ["--port", "3101", "--", "mcpvault", "/vault"]
```
| Питфолл | Симптом | Фикс |
|---|---|---|
| У `mcp-proxy` **нет** флага `--host` | контейнер падает на разборе аргументов | только `--port N -- <cmd> <args>`; слушает `0.0.0.0` по умолчанию |
| Точка монтирования должна существовать в образе | mcpvault стартует не в том каталоге | `RUN mkdir -p /vault` + `WORKDIR /vault` в Dockerfile |
Проверка живости: `curl -o /dev/null -w "%{http_code}" http://<host>:3101/sse` → **200**.
Endpoint для MCP-клиента — `/sse` (не `/mcp`; `/mcp` отдаёт 400).
📌 Для Балды на Kraken волт монтируется **`:ro`** — агент читает документацию,
но не правит её. Запись в волт через агента — отдельное решение.
### 2. cyanheads/obsidian-mcp-server — REST API, самый популярный по загрузкам
- **npm:** `obsidian-mcp-server`