BNCC MCP Server

Servidor MCP (Model Context Protocol) que expõe a BNCC (Base Nacional Comum Curricular — Educação Infantil e Ensino Fundamental) e a BNCC Computação para que assistentes de IA criem soluções educacionais alinhadas ao currículo de forma controlada e precisa — sem inventar códigos de habilidade.

• 1.397 habilidades da BNCC geral (EI + EF)
• 115 habilidades da BNCC Computação (eixos: Pensamento Computacional, Mundo Digital, Cultura Digital)
• Todos os metadados (etapa, área, componente, ano/grupo, campo de experiência, eixo) derivados diretamente do código oficial da habilidade.

Por que usar

Ao invés de deixar a IA "lembrar" da BNCC (o que leva a códigos e descrições inventados), o servidor oferece consultas determinísticas sobre os dados oficiais: busca por tema, filtro por ano/componente/eixo, obtenção por código e validação de código para evitar alucinações.

Estrutura

bncc-mcp-server/
├── bncc_mcp/
│   ├── data.py            # carregamento, indexação e consulta (busca/validação/taxonomia)
│   └── server.py          # servidor FastMCP: tools + resources
├── data/
│   ├── bncc_geral.json    # 1397 habilidades EI + EF
│   └── bncc_computacao.json  # 115 habilidades de Computação
├── scripts/
│   └── extract_bncc.py    # (re)gera os JSON a partir dos PDFs oficiais
├── .vscode/mcp.json       # configuração pronta para o VS Code
├── pyproject.toml
└── requirements.txt

Instalação

Requer Python 3.10+.

python -m venv .venv
source .venv/Scripts/activate      # Windows (bash);  no Linux/macOS: source .venv/bin/activate
pip install -r requirements.txt

Como rodar

O servidor usa o transporte stdio (padrão para servidores locais). Normalmente ele é iniciado pelo cliente MCP (VS Code, Claude Desktop, etc.), mas você pode executá-lo manualmente:

python -m bncc_mcp.server

Configuração no VS Code

Já existe um .vscode/mcp.json pronto. Abra a paleta de comandos e use MCP: List Servers para iniciar o servidor bncc.

Configuração no Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "bncc": {
      "command": "C:/Users/davi.vieira/Projects/Softwares/bncc-mcp-server/.venv/Scripts/python.exe",
      "args": ["-m", "bncc_mcp.server"],
      "cwd": "C:/Users/davi.vieira/Projects/Softwares/bncc-mcp-server"
    }
  }
}

Inspecionar com o MCP Inspector

mcp dev bncc_mcp/server.py

Ferramentas (tools)

Ferramenta	Descrição
buscar_habilidades	Busca por tema/palavra-chave e filtros (fonte, etapa, área, componente, ano, campo, eixo). Robusta a acentos e plurais.
obter_habilidade	Retorna os dados completos de uma habilidade pelo código exato (ou sugestões, se não existir).
validar_codigo	Verifica se um código de habilidade existe — use antes de citar qualquer código.
listar_taxonomia	Lista os valores válidos de filtro, os totais e o formato dos códigos.

Recursos (resources)

URI	Descrição
bncc://taxonomia	Visão geral: etapas, áreas, componentes, eixos e totais.
bncc://habilidade/{codigo}	Habilidade individual, endereçável por código.
bncc://geral	Conjunto completo da BNCC (EI + EF).
bncc://computacao	Conjunto completo da BNCC Computação.

Formato dos códigos

• BNCC: E[F|I] + ano/grupo (2) + componente/campo (2) + sequência (2). Ex.: EF01MA01, EF15LP03, EI03EO02.
• Computação: E[F|I] + ano/grupo (2) + CO + sequência (2). Ex.: EF06CO03, EI03CO01.

Regenerar os dados

Os arquivos em data/ são gerados a partir dos PDFs oficiais na raiz do repositório:

pip install -r requirements.txt   # inclui pymupdf
python scripts/extract_bncc.py

Observação: o PDF geral tem a tabela de referência (xref) danificada e só abre com PyMuPDF (não com pdfplumber). Os avisos Failed to read JPX header referem-se a imagens e não afetam a extração de texto.

Fontes

• BNCC (Educação Infantil e Ensino Fundamental) — BNCC_EI_EF_110518_versaofinal_site.pdf
• BNCC Computação (Complemento) — BNCCComputaoCompletodiagramado.pdf