enem-mcp

Servidor MCP para estudar para o ENEM com as questões oficiais (2009–2023), usando a API pública 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

No Claude, abra Configurações → Conectores → Adicionar conector personalizado.
Em Nome, escreva ENEM.
Em URL do servidor MCP, cole: https://enem-mcp.onrender.com/mcp
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)

Baixe o arquivo enem-mcp.mcpb da página de releases.
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

claude mcp add enem -- uvx enem-mcp

Outros clientes

Requer uv (ou Python 3.10+ com pip install enem-mcp).

VS Code

Adicione ao .vscode/mcp.json (ou às configurações de usuário):

{
  "servers": {
    "enem": {
      "type": "stdio",
      "command": "uvx",
      "args": ["enem-mcp"]
    }
  }
}

Cursor / outros clientes

{
  "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

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: 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 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.

Créditos

Dados da 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.

ENEM

PLUG IN

README