Skip to main content
Glama

BNCC MCP

CI PyPI Python License: MIT

Servidor MCP que expõe as habilidades da Base Nacional Comum Curricular (Educação Infantil, Ensino Fundamental e Ensino Médio) com unidade temática, objeto de conhecimento e a camada de priorização do Mapa de Foco (Instituto Reúna), além das habilidades de Computação do complemento à BNCC (anexo ao Parecer CNE/CEB nº 2/2022), organizadas nos eixos Pensamento Computacional, Mundo Digital e Cultura Digital.

A BNCC (MEC) é de livre uso; o Mapa de Foco é © Instituto Reúna, sujeito a atribuição e com permissão de uso não comercial; os dados de Computação derivam de transcrição sob licença CC BY-NC-SA 4.0 — ver ATTRIBUTION.md.


Sumário


Related MCP server: Omni Skills

Acervo

Etapa

Habilidades

Enriquecimento

Ensino Fundamental

1408

100% com unidade temática + objeto de conhecimento (BNCC); eixo (Computação)

Educação Infantil

104

campos de experiência

Ensino Médio

205

área

Total

1717

Do total, 141 habilidades são de Computação (componente Computação, códigos com infixo CO, ex.: EF06CO01), oriundas do complemento à BNCC e organizadas nos eixos Pensamento Computacional, Mundo Digital e Cultura Digital (no Ensino Médio as habilidades não são divididas por eixo).

Mapa de Foco — 396 habilidades priorizadas com classificação, conhecimento prévio, objetivos de aprendizagem, competências e habilidades relacionadas e comentários:

Componente

Em foco

Língua Portuguesa

127

Matemática

123

Ciências

56

Geografia

53

História

37


Instalação

Requer Python 3.10+.

pip install bncc-mcp          # quando publicado no PyPI
# ou, a partir do código-fonte:
pip install .
# para desenvolvimento:
pip install -e .

Com uv não é preciso instalar nada antes — uvx bncc-mcp baixa e executa o pacote do PyPI sob demanda.


Configuração no Claude Code

Após instalar o pacote:

claude mcp add bncc --scope user -- python -m bncc_mcp

Ou manualmente em .mcp.json / configuração de MCP:

{
  "mcpServers": {
    "bncc": {
      "command": "python",
      "args": ["-m", "bncc_mcp"]
    }
  }
}

Usuários de uv: se você roda Python pelo uv, não há um python solto no PATH. Use uvx bncc-mcp (recomendado — dispensa instalação) ou uv run python -m bncc_mcp:

claude mcp add bncc --scope user -- uvx bncc-mcp
{
  "mcpServers": {
    "bncc": {
      "command": "uvx",
      "args": ["bncc-mcp"]
    }
  }
}

As tools aparecem como mcp__bncc__<nome> na sessão seguinte (servidores adicionados durante uma sessão não carregam retroativamente).


Tools

bncc_lookup(codigo)

Retorna o registro completo de uma habilidade pelo código.

Parâmetro

Tipo

Obrigatório

Descrição

codigo

string

sim

Código da habilidade (ex.: EF06MA01, EF01LP01, EM13LGG101). Case-insensitive.

Quando a habilidade está no Mapa de Foco, o objeto mapa_foco é incluído. Código inexistente devolve {"erro": ..., "dica": ...}.

Exemplo — bncc_lookup("EF06MA01"):

{
  "codigo": "EF06MA01",
  "etapa": "Ensino Fundamental",
  "componente": "Matemática",
  "ano_ou_faixa": "06",
  "campo_experiencia": "",
  "unidade_tematica": "Números",
  "objeto_conhecimento": "Sistema de numeração decimal: características, leitura, escrita e comparação de números naturais e de números racionais representados na forma decimal",
  "habilidade": "Comparar, ordenar, ler e escrever números naturais e números racionais cuja representação decimal é finita, fazendo uso da reta numérica.",
  "em_foco": true,
  "mapa_foco": {
    "classificacao": "AF",
    "conhecimento_previo": "EF05MA01, EF05MA02, EF05MA05 e EF05MA07",
    "objetivos_aprendizagem": "• Ler e escrever números naturais e números racionais decimais\n• Comparar ...",
    "competencias_relacionadas": "CG: 1 e 4",
    "habilidades_relacionadas": "EF06MA05 EF06MA12",
    "comentarios": "..."
  }
}

bncc_buscar(texto, etapa, componente, ano, apenas_em_foco, limite)

Busca habilidades por palavra-chave no enunciado/objeto/unidade (acento-insensível), com filtros opcionais. Todos os termos do texto precisam estar presentes (AND).

Parâmetro

Tipo

Padrão

Descrição

texto

string

""

Termo(s) a buscar. Vazio = só aplica filtros.

etapa

string

""

Ensino Fundamental, Educação Infantil, Ensino Médio (substring).

componente

string

""

Ex.: Matemática, Língua Portuguesa, Ciências (substring, casa também area do EM).

ano

string

""

Ver semântica do filtro de ano.

apenas_em_foco

bool

false

Restringe às habilidades do Mapa de Foco.

limite

int

30

Máximo de resultados.

Retorno: { "total": int, "exibindo": int, "resultados": [ {codigo, etapa, componente, ano, em_foco, habilidade} ] }

Exemplo — bncc_buscar(texto="fração", componente="Matemática", apenas_em_foco=true, limite=3):

{
  "total": 4,
  "exibindo": 3,
  "resultados": [
    {"codigo": "EF06MA07", "etapa": "Ensino Fundamental", "componente": "Matemática", "ano": "06", "em_foco": true, "habilidade": "Compreender, comparar e ordenar frações associadas às ideias de ..."}
  ]
}

bncc_listar(componente, ano, etapa, limite)

Lista as habilidades de um recorte (componente + ano), com unidade temática e objeto de conhecimento de cada uma.

Parâmetro

Tipo

Padrão

Descrição

componente

string

— (obrigatório)

Ex.: Matemática.

ano

string

""

Vazio = todos os anos do componente.

etapa

string

""

Opcional, para desambiguar.

limite

int

100

Máximo de resultados.

Retorno: { "componente", "ano", "total", "exibindo", "resultados": [ {codigo, ano, unidade_tematica, objeto_conhecimento, em_foco, habilidade} ] }


bncc_mapa_de_foco(componente, ano, limite)

Retorna as habilidades priorizadas no Mapa de Foco, com toda a camada pedagógica.

Parâmetro

Tipo

Padrão

Descrição

componente

string

""

Vazio = todos os componentes cobertos.

ano

string

""

Vazio = todos os anos.

limite

int

100

Máximo de resultados.

Retorno: { "componente", "ano", "total", "exibindo", "resultados": [ {codigo, componente, ano, unidade_tematica, objeto_conhecimento, habilidade, mapa_foco} ] }

Exemplo — bncc_mapa_de_foco(componente="História", ano="6", limite=1):

{
  "componente": "História",
  "ano": "6",
  "total": 23,
  "exibindo": 1,
  "resultados": [
    {
      "codigo": "EF06HI01",
      "componente": "História",
      "ano": "06",
      "unidade_tematica": "História: tempo, espaço e formas de registros",
      "objeto_conhecimento": "A questão do tempo, sincronias e diacronias: reflexões sobre o sentido das cronologias",
      "habilidade": "Identificar diferentes formas de compreensão da noção de tempo e de periodização dos processos históricos (continuidades e rupturas).",
      "mapa_foco": {
        "classificacao": "AF",
        "conhecimento_previo": "EF05HI07",
        "objetivos_aprendizagem": "• Identificar e analisar diferentes noções de tempo.\n• Construir os conceitos de sincronia e de diacronia ...",
        "competencias_relacionadas": "CG: 1 e 2\nCA: 2, 4 e 5\nCE: 2 e 6",
        "habilidades_relacionadas": "AF:\n- EF06GE11: amplia o conhecimento da AF.\n- EF06GE08: amplia o conhecimento da AF.",
        "comentarios": "Ao se trabalhar características físico-naturais da superfície terrestre ..."
      }
    }
  ]
}

Campos do mapa_foco:

Campo

Conteúdo

classificacao

Classificação da habilidade no Mapa de Foco (ex.: AF).

conhecimento_previo

Códigos de habilidades pré-requisito de anos anteriores.

objetivos_aprendizagem

Objetivos de aprendizagem desdobrados (lista com •).

competencias_relacionadas

Competências gerais (CG), de área (CA) e específicas (CE).

habilidades_relacionadas

Códigos de habilidades relacionadas.

comentarios

Comentário pedagógico / orientações de trabalho.


bncc_estatisticas()

Resumo do acervo. Sem parâmetros.

{
  "total_habilidades": 1717,
  "por_etapa": {"Ensino Fundamental": 1408, "Educação Infantil": 104, "Ensino Médio": 205},
  "em_foco_total": 396,
  "em_foco_por_componente": {"Ciências": 56, "Geografia": 53, "História": 37, "Língua Portuguesa": 127, "Matemática": 123}
}

Esquema dos registros

Campos retornados por bncc_lookup (varia conforme a etapa):

Campo

Etapas

Descrição

codigo

todas

Código da habilidade.

etapa

todas

Ensino Fundamental / Educação Infantil / Ensino Médio.

componente

EF

Componente curricular.

area

EM

Área do Ensino Médio.

ano_ou_faixa

EF/EI

Ano ('06') ou faixa ('69'); faixa etária para EI.

campo_experiencia

EI

Campo de experiência.

unidade_tematica

EF

Unidade temática (ou prática de linguagem / eixo).

eixo

Computação

Eixo da habilidade (Pensamento Computacional, Mundo Digital ou Cultura Digital); replicado em unidade_tematica.

objeto_conhecimento

EF

Objeto de conhecimento.

habilidade

todas

Enunciado da habilidade.

em_foco

todas

true se está no Mapa de Foco.

mapa_foco

em foco

Objeto com a camada pedagógica (ver acima).


Semântica do filtro de ano

O parâmetro ano aceita 6, 06 ou 6º (a pontuação é ignorada) e segue a convenção de codificação da BNCC:

  • Ano único vem com zero à esquerda: 06 = 6º ano.

  • Faixa vem sem zero, com 1º dígito < 2º: 69 = 6º ao 9º, 15 = 1º ao 5º, 35 = 3º ao 5º, 12 = 1º e 2º.

Buscar ano="6" retorna tanto as habilidades exclusivas do 6º ano (EF06...) quanto as de faixas que incluem o 6º (EF69..., EF67...).


Procedência dos dados

Os CSVs da BNCC em data/ (bncc_habilidades.csv e bncc_em.csv) são gerados por dois scripts no diretório-pai do projeto; o de Computação (bncc_comp.csv) é obtido de fonte externa (item 3):

  1. extrair_objetos.py — extrai unidade temática + objeto de conhecimento do PDF oficial da BNCC (EI/EF), explorando o layout em spread de duas páginas e casando por coordenada vertical. Cobre 100% das 1304 habilidades EF.

  2. add_mapa_foco.py — lê a planilha unificada do Mapa de Foco (MapasDeFocoBncc_Unificados.xlsx, Instituto Reúna) e acrescenta as 7 colunas do Mapa de Foco para as 396 habilidades selecionadas.

Para regerar: rodar os dois scripts (nessa ordem) e copiar BNCC_habilidades_enriquecido.csv → data/bncc_habilidades.csv e bncc_em_habilidades.csv → data/bncc_em.csv.

  1. data/bncc_comp.csv (Computação) — obtido em computacional.com.br/bncc (Prof. Christian Brackmann / Instituto Federal Farroupilha — IFFAR, conteúdo sob licença CC BY-NC-SA 4.0), adaptado de "Computação — Complemento à BNCC", anexo ao Parecer CNE/CEB nº 2/2022 (MEC).


Limitações

  • O Mapa de Foco cobre Língua Portuguesa, Matemática, Ciências, História e Geografia do Ensino Fundamental. Para Arte, Educação Física, Língua Inglesa, Ensino Religioso, Computação, Educação Infantil e Ensino Médio, em_foco é sempre false — porque não há Mapa de Foco publicado para esses, não por lacuna do acervo.

  • Educação Infantil não tem unidade temática nem objeto de conhecimento (usa campos de experiência); esses campos ficam vazios para EI.

  • As habilidades de Computação não têm objeto de conhecimento (a norma organiza por eixos); no Ensino Médio nem o eixo é definido.


Estrutura do projeto

bncc-mcp/
├── pyproject.toml        # empacotamento; console script `bncc-mcp`
├── README.md             # este arquivo
├── LICENSE               # MIT (cobre o código)
├── ATTRIBUTION.md        # proveniência e licenças dos dados
├── CHANGELOG.md
├── bncc_mcp/
│   ├── __init__.py
│   ├── __main__.py       # `python -m bncc_mcp`
│   ├── server.py         # servidor MCP (FastMCP), 5 tools
│   └── data/
│       ├── bncc_habilidades.csv   # EI + EF, enriquecido + Mapa de Foco
│       ├── bncc_em.csv            # Ensino Médio
│       └── bncc_comp.csv          # Computação (complemento à BNCC)
└── tests/
    └── test_server.py

Licença e atribuição

  • Código: licença MIT (ver LICENSE).

  • Dados: a BNCC (MEC) é de livre uso; o Mapa de Foco é © 2020 Instituto Reúna e seu reuso exige atribuição e é restrito a fins não comerciais; os dados de Computação derivam de transcrição do Prof. Christian Brackmann (IFFAR) sob licença CC BY-NC-SA 4.0. Detalhes e forma de citar em ATTRIBUTION.md.

Dados da BNCC: Ministério da Educação (MEC). Camada de priorização: Mapas de Foco da BNCC © 2020 Instituto Reúna (institutoreuna.org.br), usados com autorização. Habilidades de Computação: complemento à BNCC (CNE/MEC), transcrição de computacional.com.br (Prof. Christian Brackmann / IFFAR, CC BY-NC-SA 4.0).

Available Tools

5 tools
bncc_buscarA

Busca habilidades por palavra-chave no enunciado (acento-insensível), com filtros opcionais por etapa, componente, ano e Mapa de Foco.

Args: texto: termo(s) a buscar no enunciado/objeto/unidade (vazio = só filtros). etapa: 'Ensino Fundamental', 'Educação Infantil', 'Ensino Médio'. componente: ex. 'Matemática', 'Língua Portuguesa', 'Ciências'. ano: ex. '6' ou '06'; casa também intervalos ('69' = 6º ao 9º). apenas_em_foco: se True, restringe às habilidades do Mapa de Foco. limite: máximo de resultados (padrão 30).

Inputs: texto, etapa, componente, ano, +2 more.

bncc_estatisticasA

Resumo do acervo: contagem de habilidades por etapa e por componente, e quantas estão no Mapa de Foco.

Inputs: no named parameters.

bncc_listarB

Lista as habilidades de um recorte (componente + ano), com a unidade temática e o objeto de conhecimento de cada uma.

Args: componente: ex. 'Matemática' (obrigatório). ano: ex. '6'; vazio = todos os anos do componente. etapa: opcional, para desambiguar. limite: máximo de resultados (padrão 100).

Inputs: componente (required), ano, etapa, limite.

bncc_lookupA

Retorna o registro completo de uma habilidade da BNCC pelo código (ex.: 'EF06MA01', 'EF01LP01', 'EM13LGG101').

Inclui enunciado, etapa, componente, ano, unidade temática, objeto de conhecimento e — quando a habilidade está no Mapa de Foco — toda a camada de priorização (classificação, conhecimento prévio, objetivos de aprendizagem, competências e habilidades relacionadas, comentários).

Inputs: codigo (required).

bncc_mapa_de_focoA

Retorna as habilidades priorizadas no Mapa de Foco da BNCC (Instituto Reúna), com toda a camada pedagógica: classificação, conhecimento prévio, objetivos de aprendizagem, competências e habilidades relacionadas e comentários.

O Mapa de Foco cobre Língua Portuguesa, Matemática, Ciências, História e Geografia (Ensino Fundamental). Não há Mapa de Foco para Arte, Educação Física, Língua Inglesa, Ensino Religioso, Educação Infantil ou Ensino Médio.

Args: componente: ex. 'Matemática'; vazio = todos os componentes cobertos. ano: ex. '6'; vazio = todos os anos. limite: máximo de resultados (padrão 100).

Inputs: componente, ano, limite.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation: search by keyword, summary statistics, list by component/year, full record lookup by code, and the Mapa de Foco prioritized skills. No two tools overlap in purpose.

    Naming Consistency4/5

    All tools share the 'bncc_' prefix and use verbs or descriptive nouns, but 'lookup' is English while others are Portuguese, and 'estatisticas' is a noun rather than a verb like the rest.

    Tool Count5/5

    With 5 tools for a focused domain (Brazilian BNCC curriculum), the set is well-scoped, covering search, listing, stats, lookup, and a special focus map. No tool feels redundant or missing.

    Completeness4/5

    The surface covers key CRUD-like operations and the special Mapa de Foco, but lacks a tool for listing all components or years, which would improve completeness.

    Related MCP Connectors

    Related MCP Servers