enem-mcp
# enem-mcp
<!-- mcp-name: io.github.jpmamededs/enem-mcp -->
Servidor [MCP](https://modelcontextprotocol.io) para estudar para o ENEM com as **questões oficiais (2009–2023)**, usando a API pública [enem.dev](https://enem.dev).
- Consulte qualquer questão e seu gabarito, com as imagens (gráficos, mapas, tirinhas)
- Busque questões por tema, disciplina e ano
- Crie simulados — inclusive em **PDF** com folha de respostas, página "GABARITO ABAIXO" e questões resolvidas com explicação
- Corrija simulados e acompanhe seu desempenho por disciplina, com revisão das questões erradas
## Instalação
### Claude (site, app desktop e celular) — sem instalar nada
1. No Claude, abra **Configurações → Conectores → Adicionar conector personalizado**.
2. Em **Nome**, escreva `ENEM`.
3. Em **URL do servidor MCP**, cole: `https://enem-mcp.onrender.com/mcp`
4. Clique em **Adicionar**. Pronto: é só pedir no chat, por exemplo *"faz um simulado de 10 questões de geometria"*.
Nesse modo os PDFs vêm como link de download (válido por 7 dias). Histórico de desempenho e simulados de revisão só existem na instalação local, abaixo.
### Claude Desktop (um clique)
1. Baixe o arquivo **`enem-mcp.mcpb`** da [página de releases](https://github.com/jpmamededs/enem-mcp/releases/latest).
2. Dê dois cliques no arquivo (ou arraste para a janela do Claude Desktop) e clique em **Instalar**.
Não é preciso instalar Python: o Claude Desktop cuida de tudo.
### Claude Code
```bash
claude mcp add enem -- uvx enem-mcp
```
### Outros clientes
Requer [uv](https://docs.astral.sh/uv/getting-started/installation/) (ou Python 3.10+ com `pip install enem-mcp`).
#### VS Code
Adicione ao `.vscode/mcp.json` (ou às configurações de usuário):
```json
{
"servers": {
"enem": {
"type": "stdio",
"command": "uvx",
"args": ["enem-mcp"]
}
}
}
```
#### Cursor / outros clientes
```json
{
"mcpServers": {
"enem": {
"command": "uvx",
"args": ["enem-mcp"]
}
}
}
```
## Ferramentas
| Ferramenta | Descrição |
|---|---|
| `listar_provas` | Anos disponíveis, disciplinas e idiomas |
| `obter_questao` | Enunciado, alternativas e imagens de uma questão |
| `obter_resposta` | Gabarito oficial de uma questão |
| `questao_aleatoria` | Sorteia uma questão para praticar |
| `buscar_questoes` | Busca por tema (palavras-chave), disciplina e ano |
| `criar_simulado` | Simulado por tema/disciplina/ano, opcionalmente em PDF |
| `preparar_explicacoes` / `exportar_simulado_pdf` | Gera o PDF com as questões resolvidas e explicadas |
| `corrigir_simulado` | Corrige e salva o resultado |
| `listar_simulados` / `meu_desempenho` | Histórico e estatísticas |
| `criar_simulado_revisao` | Simulado só com as questões que você errou |
Prompts: `explicar_questao`, `sessao_de_estudo`, `simulado_pdf_explicado`, `plano_de_estudos`.
Exemplos de pedidos: *"faz um simulado em PDF com 15 questões de genética, com explicação no final"*, *"qual a resposta da questão 136 do ENEM 2021?"*.
## Configuração (opcional)
| Variável | Padrão |
|---|---|
| `ENEM_PDF_DIR` | `Downloads/simulados-enem` |
| `ENEM_MCP_DIR` | Windows: `%LOCALAPPDATA%\enem-mcp`; macOS: `~/Library/Application Support/enem-mcp`; Linux: `~/.local/share/enem-mcp` |
A API enem.dev aceita 1 requisição por segundo; as provas baixadas ficam em cache local, então só a primeira consulta de cada ano é lenta.
## Desenvolvimento
```bash
uv venv && uv pip install -e .
uv run enem-mcp # stdio (local)
uv run enem-mcp --http # servidor remoto em http://127.0.0.1:8000/mcp
```
### Hospedar o servidor remoto
O repositório tem `Dockerfile` e `render.yaml`. No [Render](https://render.com): **New → Blueprint**, escolha este repositório e confirme. O endereço do conector será `https://<nome-do-serviço>.onrender.com/mcp`. Em outras plataformas, use o `Dockerfile` e defina `ENEM_MCP_URL_PUBLICA` com o endereço público (usado nos links dos PDFs).
## Política de privacidade
- **Dados coletados:** apenas os parâmetros das ferramentas (ex.: ano, tema, respostas de um simulado). Não há cadastro, login, nem coleta de nome, e-mail ou dados do dispositivo.
- **Uso e armazenamento:** os simulados (questões sorteadas, respostas e explicações) são guardados para permitir correção e geração de PDF. Na instalação local, ficam só no seu computador. No servidor remoto, ficam no servidor, identificados apenas por um código aleatório.
- **Compartilhamento com terceiros:** o servidor consulta a API pública [enem.dev](https://enem.dev) para obter questões e imagens; nenhum dado seu é enviado a ela além do ano/número da questão. Nada é vendido ou compartilhado.
- **Retenção:** no servidor remoto, PDFs são apagados após 7 dias; simulados podem ser apagados a qualquer momento em reinicializações. Localmente, os dados ficam até você apagar a pasta `enem-mcp`.
- **Contato:** abra uma issue em [github.com/jpmamededs/enem-mcp/issues](https://github.com/jpmamededs/enem-mcp/issues).
## Créditos
Dados da [enem-api](https://github.com/yunger7/enem-api) (GPL-2.0). Questões do ENEM são de domínio público (INEP). Este projeto não é afiliado ao INEP nem ao MEC.
Licença: MIT.
TDQS
Scored across 12 tools
Each tool targets a fairly distinct step: listing exams, searching, fetching a question, fetching the answer key, creating/correcting/saving/exporting simulados. Minor overlap between questao_aleatoria and obter_questao (both return a full question, differing only by selection method) and between criar_simulado's optional PDF and exportar_simulado_pdf, but descriptions clarify the intended flow.
Names are uniformly snake_case in Portuguese with mostly verb_noun form (listar_provas, obter_questao, criar_simulado, corrigir_simulado, exportar_simulado_pdf). Two deviations break the pattern: questao_aleatoria and meu_desempenho are noun/possessive phrases rather than verb-first, but overall it reads predictably.
12 tools map cleanly onto the workflow of listing exams, browsing/searching questions, checking answers, building and grading simulados, viewing stats, and review practice. No tool feels redundant, and the set is well within a sensible range.
The surface covers the full simulado lifecycle (create, list, correct, export PDF, review missed questions) plus question retrieval and performance stats. Minor gaps exist, such as no tool to delete a simulado or refine export options beyond regeneration, but core workflows are fully supported.