Obsidian MCP ANA

Plugin para Obsidian que funciona como servidor MCP (expõe o vault) e cliente MCP (conecta a servidores externos como MCP ANA PJe, DataJud, etc.) simultaneamente. Compatível com Claude Desktop, Claude Code e qualquer cliente MCP.

---

O que é MCP?

Model Context Protocol (MCP) é o protocolo aberto da Anthropic para conectar LLMs (como Claude) a ferramentas e dados externos. Este plugin substitui o mcp-obsidian (descontinuado) com funcionalidades adicionais.

---

Instalação

Via BRAT (recomendado)

1. Instale o plugin BRAT (Obsidian42 - BRAT) pela comunidade.
2. Configurações → BRAT → Add Beta Plugin → cole: https://github.com/Jorgelaw/obsidian-mcp-ana
3. Ative o "MCP ANA" em Plugins da comunidade.

Manual

Baixe main.js, manifest.json e styles.css (da release ou do repositório) e coloque em .obsidian/plugins/obsidian-mcp-ana/. Em seguida, ative o "MCP ANA".

Desenvolvimento

cd /caminho/do/vault/.obsidian/plugins/
git clone https://github.com/Jorgelaw/obsidian-mcp-ana
cd obsidian-mcp-ana
npm install
npm run build

---

Configuração

Servidor MCP Local (vault → Claude)

Após ativar, o servidor inicia automaticamente em http://localhost:27123.

Claude Desktop (claude_desktop_config.json) — use o transporte via mcp-remote:

{
  "mcpServers": {
    "obsidian-mcp-ana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:27123/sse"]
    }
  }
}

O servidor implementa o transporte MCP HTTP+SSE (evento endpoint + respostas pelo stream SSE), compatível com mcp-remote e demais clientes MCP.

Servidores Externos (Obsidian → PJe/DataJud)

Em Configurações → MCP ANA → Servidores MCP Externos:

1. Clique em + Adicionar ou use um preset (MCP ANA PJe, MCP Nacional)
2. Insira a URL SSE e o token de autenticação
3. Ative o toggle do servidor

Os resultados podem ser injetados automaticamente como notas Markdown na pasta configurada (padrão: _mcp-results/).

---

Ferramentas (26)

Notas e vault

Tool	Descrição
read_note / get_vault_file	Lê o conteúdo de uma nota
write_note / create_vault_file	Cria ou sobrescreve uma nota
append_note / append_to_vault_file	Adiciona texto ao final de uma nota
patch_vault_file	Insere/substitui relativo a heading, bloco (^id) ou frontmatter
delete_vault_file	Move um arquivo para a lixeira (ou exclui)
list_files / list_vault_files	Lista arquivos/pastas do vault
get_metadata	Retorna frontmatter e metadados
open_note / show_file_in_obsidian	Abre uma nota no editor
run_command / list_commands	Executa/lista comandos do Obsidian

Busca

Tool	Descrição
search_vault / search_vault_simple	Busca textual no vault
search_vault_smart	Busca semântica (via Smart Connections)

Nota ativa (editor)

Tool	Descrição
get_active_file	Lê a nota aberta no editor
update_active_file	Sobrescreve a nota ativa
append_to_active_file	Adiciona ao final da nota ativa
patch_active_file	Patch na nota ativa (heading/bloco/frontmatter)
delete_active_file	Move a nota ativa para a lixeira

Outras

Tool	Descrição
get_server_info	Informações do servidor (vault, tools, porta)
fetch	Busca o conteúdo de uma URL na web
execute_template	Executa um template do Templater

---

Integração com Projeto ANA (TJMA)

Este plugin foi projetado para funcionar no ecossistema ANA do TJMA:

Claude Code / Claude Desktop
         ↕ (MCP)
   Obsidian Vault (este plugin)
         ↕ (MCP client)
   MCP ANA PJe / MCP Nacional
         ↕
      PJe TJMA

Exemplo de uso:

1. Claude lê uma nota de análise do vault (read_note)
2. Claude consulta o PJe via MCP ANA PJe embutido no cliente externo
3. Claude escreve a minuta de volta no vault (write_note)

---

Endpoints HTTP

Endpoint	Método	Descrição
/health	GET	Status do servidor
/sse	GET	Transporte SSE para clientes MCP
/mcp	POST	JSON-RPC (com ?sessionId= no transporte SSE)

---

Segurança

• O servidor escuta apenas em 127.0.0.1 (loopback) — não exposto à rede
• Token Bearer opcional para autenticação
• Para uso remoto, configure um túnel seguro (ex: Cloudflare Tunnel)

---

Estrutura do projeto

obsidian-mcp-ana/
├── src/
│   └── main.ts              # Entry point do plugin
├── server/
│   └── McpServer.ts         # Servidor MCP HTTP/SSE
├── client/
│   └── McpClientManager.ts  # Cliente para servidores externos
├── settings/
│   └── SettingTab.ts        # UI de configurações
├── styles.css
├── manifest.json
├── package.json
└── tsconfig.json

---

Licença

MIT — ToadaLab / TJMA