vault-mcp-server

MCP server genérico pra consultar e alimentar um vault Obsidian (ou qualquer pasta de arquivos .md). Não sabe nada sobre a estrutura de nenhum vault específico — isso é responsabilidade do AGENTS.md/convenções de cada vault, lido pelo agente que usa as tools, não codificado aqui.

Ferramentas

Limitação conhecida: rename_note/move_note não reescrevem [[wikilinks]] que outras notas tenham pra elas (diferente do Obsidian, que faz isso automaticamente pela UI). Rode get_backlinks antes de renomear pra saber o que pode quebrar.

write_note não faz git. Só grava o arquivo — commit/push continua manual (mesmo fluxo que o AGENTS.md de cada vault já deve documentar pra agentes com acesso a shell).

Variáveis de ambiente

Segurança

Todo caminho é resolvido e validado contra escapar da raiz do vault (sem .., sem caminho absoluto fora do vault). Só arquivos .md são lidos/escritos. Pastas de topo em VAULT_MCP_BLOCKED_FOLDERS (+ as três padrão) ficam fora tanto de leitura quanto de escrita.

Registro

Pra este vault específico (~/vault), bloqueando também _scripts/ (é tooling, não notas):

claude mcp add --scope user vault \
  --env VAULT_MCP_ROOT=$HOME/vault \
  --env VAULT_MCP_BLOCKED_FOLDERS=_scripts \
  -- uv run --directory ~/dev/pessoal/vault-mcp-server server.py

--scope user deixa disponível em qualquer sessão do Claude Code, em qualquer repo — não só quando se está dentro do vault. O mesmo binário serve qualquer outro vault só trocando VAULT_MCP_ROOT.

Codex CLI ainda não está instalado nesta máquina; quando estiver, o mesmo servidor se registra via entrada mcp_servers no config.toml do Codex, apontando pro mesmo comando (uv run --directory ... server.py) com as mesmas env vars.