mcp-obsidian-local

Servidor MCP local em stdio para acessar o plugin obsidian-local-rest-api.

Agora ele tambem suporta indice semantico local com Ollama, sem custo recorrente.

Variaveis de ambiente

setx OBSIDIAN_API_URL "http://127.0.0.1:27123"
setx OBSIDIAN_API_KEY "da1bc2c78963ef1c79e7a38fc8eef1f049cd39724278510d452395ec18031d44"
setx OLLAMA_BASE_URL "http://127.0.0.1:11434"
setx OLLAMA_EMBED_MODEL "embeddinggemma"

Abra uma nova sessao depois de definir as variaveis.

Related MCP server: obsidian-local-mcp

Ollama

Instalacao:

winget install -e --id Ollama.Ollama --accept-source-agreements --accept-package-agreements

Subir o servidor local:

ollama serve

Baixar o modelo de embeddings:

ollama pull embeddinggemma

Instalar dependencias

npm install

Rodar localmente

npm start

Configuracao no Codex

Adicione isto ao C:\Users\rodrigo.souza\.codex\config.toml:

[mcp_servers.obsidian_local]
command = "node"
args = ["C:\\Users\\rodrigo.souza\\Documents\\projetos\\mcp-obsidian-local\\src\\index.js"]

Depois reinicie a sessao do Codex.

Camadas

1. Estrutura

• obsidian_get_note_metadata

• obsidian_extract_links

• obsidian_get_backlinks

• obsidian_get_note_neighbors

• obsidian_list_notes_by_tag

• obsidian_list_notes_by_frontmatter

• obsidian_get_tags

2. Recuperacao para IA

• obsidian_find_related_notes

• obsidian_build_context_bundle

• obsidian_project_memory

• obsidian_summarize_note_cluster

• obsidian_refresh_index

• obsidian_rebuild_semantic_index

• obsidian_semantic_search_notes

3. Atualizacao do segundo cerebro

• obsidian_write_note

• obsidian_append_note

• obsidian_upsert_frontmatter

• obsidian_append_context_section

• obsidian_open_note

Base

• obsidian_get_status

• obsidian_list_files

• obsidian_read_note

• obsidian_delete_note

• obsidian_search_notes

Resources

• obsidian://status

• obsidian://note/{path}

• obsidian://note-metadata/{path}

Indice semantico

O indice vetorial e persistido em:

data/semantic-index.json

Fluxo recomendado:

npm start

Depois, via MCP:

• rode obsidian_refresh_index

• rode obsidian_rebuild_semantic_index

• use obsidian_semantic_search_notes

• use obsidian_build_context_bundle

• use obsidian_project_memory

O bundle hibrido combina:

• relacoes por links e backlinks

• tags e frontmatter

• busca lexical simples

• similaridade vetorial local via Ollama

Memoria de projeto

obsidian_project_memory monta um pacote de memoria orientado a projeto para codificacao e analise.

Entrada:

• project

• module opcional

• topic opcional

• limit

Saida:

• notas principais do projeto

• mapa de relacionamentos entre essas notas

• hits semanticos locais

• lacunas de documentacao como arquitetura, ADRs, API, dados e operacao

• guidance para decidir o que ler e o que atualizar no vault