MCP server for searching, reading and writing an Obsidian knowledge vault: lexical BM25 retrieval plus one wiki-link hop, and learning capture that propagates to the domain MOC, the knowledge index and the daily note in a single commit.
Strong foundation with 9 well-named tools following verb_noun convention (vault_search, vault_get_note, vault_write_note, etc.). All tools have descriptions (avg ~150 chars, within 10-1024 baseline). Input schemas are present and use Zod with type definitions. However, parameter descriptions are sparse or missing in several tools (vault_list has empty input schema; vault_backlinks lacks detail on return format). Output schemas are not documented in tool definitions, LLMs cannot predict response structure. Error handling exists but lacks recovery guidance. Tool composition is sound (single responsibility, proper chaining via path/domain fields). Security considerations present (read-only vs write risk annotations), but no explicit permission gates or audit logging visible.
Retorna notas que apontam para um caminho dado (backlinks de wiki-link).
Apaga uma nota do vault. Requer confirmação se houver backlinks.
Edita uma nota existente: encontra um trecho e o substitui por outro. Idempotente se o trecho for único.
Lê uma nota inteira pelo caminho relativo ao vault (ex.: `02-wiki/nestjs/auth-guard.md`), com frontmatter, links resolvidos e links quebrados. Use depois de vault_search quando o trecho não bastar, ou antes de editar a nota.
Registra um aprendizado novo: cria uma nota ou anexa a uma existente, e propaga para o MOC do domínio, o índice de conhecimento e a nota diária em um único commit.
Lista notas por metadado — tipo, tags, status, pasta — sem olhar o conteúdo. Use para inventário ("quais projetos ativos existem?", "quais notas têm a tag jwt?"), não para buscar assunto: para assunto use vault_search.
vault_list has empty input schema (no parameters documented). LLM cannot understand filtering options or constraints.
Output schemas not documented in tool definitions. LLMs cannot predict response structure (fields, types, pagination). Breaks downstream tool chaining.
Error handling lacks recovery guidance. Errors like 'note not found' or 'invalid path' do not suggest next steps (e.g., 'Try vault_search() first').
Destructive operations (vault_delete, vault_move) lack explicit confirmation/dry-run pattern. Agents could accidentally delete notes without safeguards.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Move uma nota de um caminho para outro, atualizando todos os links que apontam para ela.
Busca semântica-lexical no vault (BM25 + um salto de wiki-links). Chame antes de responder qualquer pergunta sobre decisões, padrões, gotchas ou histórico do usuário, e antes de gravar um aprendizado novo. Devolve trechos já citados como `caminho:linha` — repita essa citação na resposta ao usuário. Notas de `01-raw/` ficam de fora salvo include_raw.
Cria uma nota nova ou substitui uma existente inteira. Não edita: para editar, use vault_edit_note.
No audit logging or permission gates visible. Sensitive write operations (vault_write_note, vault_learn) lack caller identity tracking or scope declarations.