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.

Related MCP server: Obsidian Claude Code MCP Server

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

Busca

Nota ativa (editor)

Outras

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

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