Update README.md

README.md

@@ -1,11 +1,109 @@
+<div align="center">
+
+```
+██╗     ███████╗██╗  ██╗
+██║     ██╔════╝╚██╗██╔╝
+██║     █████╗   ╚███╔╝
+██║     ██╔══╝   ██╔██╗
+███████╗███████╗██╔╝ ██╗
+╚══════╝╚══════╝╚═╝  ╚═╝
+```
+
+**Assistente Jurídico via MCP + Hugging Face Hub**
+
+*Modelos NLP · Datasets de Jurisprudência · Inferência ao vivo*
+
+[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org)
+[![FastMCP](https://img.shields.io/badge/FastMCP-0.4%2B-FF6B35?style=flat-square)](https://github.com/jlowin/fastmcp)
+[![HF Hub](https://img.shields.io/badge/🤗%20Hub-jurídico-FFD21E?style=flat-square)](https://huggingface.co)
+[![License](https://img.shields.io/badge/License-Apache%202.0-green?style=flat-square)](LICENSE)
+
+</div>
+
+---
+
+## O que é
+
+**LEX** é um servidor MCP especializado em domínio jurídico, construído sobre o Hugging Face Hub.  
+Ele expõe quatro ferramentas que qualquer LLM host compatível com MCP pode usar para:
+
+- Descobrir modelos de NLP treinados em textos legais
+- Explorar datasets de jurisprudência brasileira e internacional
+- Rodar análise automática em textos jurídicos (resumo, NER, classificação)
+- Pesquisar decisões judiciais por palavras-chave
+
+```
+Advogado / Sistema ──► Claude ──► LEX (MCP) ──► 🤗 Hugging Face Hub
+                                  ↑ dados ao vivo
+```
+
 ---
-title: Assistentjuri
-emoji: 😻
-colorFrom: purple
-colorTo: blue
-sdk: static
-pinned: false
-short_description: 'assistente jurídico completo '
+
+## Ferramentas
+
+| Ferramenta | Função | Modelos / Datasets |
+|---|---|---|
+| `search_legal_models` | Busca modelos NLP jurídicos | Legal-BERT, Saul-7B, stjiris/bert-pt |
+| `explore_legal_dataset` | Inspeciona datasets jurídicos | brazilian_court_decisions, lex_glue, CUAD |
+| `analyze_legal_text` | Inferência NLP em texto legal | summarization, NER, classificação |
+| `find_jurisprudence` | Busca em decisões por keyword | Corpus STF, TJSP, MultiLegalPile |
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Quickstart
+
+```bash
+git clone https://github.com/youruser/lex-mcp
+cd lex-mcp
+pip install -e .
+export HF_TOKEN=hf_...   # opcional mas recomendado
+python server.py
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "lex-mcp": {
+      "command": "python",
+      "args": ["/caminho/absoluto/lex-mcp/server.py"],
+      "env": { "HF_TOKEN": "hf_..." }
+    }
+  }
+}
+```
+
+### Interface Web
+
+Abra `interface.html` no navegador para usar a interface visual dark com chat integrado.
+
+---
+
+## Exemplos de uso
+
+> _"Quais são os melhores modelos BERT para classificação de petições em português?"_
+
+> _"Explore o dataset `joelniklaus/brazilian_court_decisions` e mostre exemplos reais"_
+
+> _"Analise este trecho e classifique a área do direito: 'rescisão contratual por inadimplemento...'"_
+
+> _"Busque decisões sobre habeas corpus nos datasets de jurisprudência brasileira"_
+
+---
+
+## Estrutura
+
+```
+lex-mcp/
+├── server.py        # FastMCP server — 4 ferramentas jurídicas
+├── interface.html   # UI dark/terminal com chat e inferência ao vivo
+├── pyproject.toml   # dependências e build config
+└── README.md        # este arquivo
+```
+
+---
+
+## License
+
+Apache 2.0