# Jurisprudências BR MCP

Servidor MCP somente de leitura para pesquisar o dataset público
[`celsowm/jurisprudencias_br`](https://huggingface.co/datasets/celsowm/jurisprudencias_br).
Ele resolve os shards Parquet pela API do Dataset Viewer e usa DuckDB remoto
para regex RE2, sem baixar o acervo inteiro.

## Ferramentas

- `search_jurisprudencia`: regex em `ementa` ou `inteiro_teor`, filtros de
  metadados e intervalo de datas.
- `filter_jurisprudencia`: prévia estruturada pelo endpoint `/filter` do
  Dataset Viewer; não executa regex.
- `dataset_status`: confirma Viewer, split e quantidade de shards.

## Instalação local

O servidor usa transporte MCP `stdio` e pode ser iniciado sem instalação
permanente:

```bash
uvx --from git+https://github.com/celsowm/jurisprudencias-br-mcp jurisprudencias-br-mcp
```

Exemplo de configuração para clientes que aceitam comandos MCP:

```json
{
  "mcpServers": {
    "jurisprudencias-br": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/celsowm/jurisprudencias-br-mcp",
        "jurisprudencias-br-mcp"
      ]
    }
  }
}
```

Regex usa RE2: lookbehind não é suportado. O resultado padrão traz metadados e
excerto; `include_full_text=true` é necessário para receber o texto integral.