Sobre o projeto

O repositório bncc-pacotes fornece interfaces de máquina para a Base Nacional Comum Curricular (BNCC), o dataset oficial da educação básica brasileira. Contém três publicações derivadas do dataset [bncc-dados](https://github.com/bncc-dev/bncc-dados): um pacote npm (`@bncc/dados`) para TypeScript/JavaScript, um pacote PyPI (`bncc`) para Python e um servidor MCP (`@bncc/mcp`) para integração com agentes de IA. Os dados (1.721 aprendizagens) são embutidos diretamente nos pacotes, eliminando dependências de runtime e necessidade de acesso à rede. A consulta ocorre localmente na máquina do usuário. O dataset é sincronizado a partir de um commit específico do repositório bncc-dados, com checksums e data-version registrados em `dados/VERSAO.json`. A API oferece funções como `porCodigo`/`por_codigo` para lookup por código (ex: `EF67LP08`), `habilidadesEF`/`habilidades_ef` para filtrar por componente, ano e prática, `buscar`/`buscar` para pesquisa textual e `decodificar`/`decodificar` para decompor códigos em suas partes constitutivas (etapa, área, competência, sequência). O servidor MCP expõe sete ferramentas (`bncc_lookup`, `bncc_buscar`, `bncc_listar`, `bncc_decodificar`, `bncc_estatisticas`, `bncc_estrutura`, `bncc_progressao_ei`) que permitem a agentes de IA consultarem a BNCC com fonte oficial em cada resposta. Códigos inexistentes retornam erros explicativos sobre lacunas legítimas da numeração, evitando alucinações. O servidor pode ser usado localmente via `npx -y @bncc/mcp` ou acessado gratuitamente em `https://mcp.bncc.dev` via HTTP streamable, sem API key. A paridade entre as implementações npm e PyPI é garantida por consultas "douradas" testadas a cada commit, conforme documentado em [docs/paridade.md](docs/paridade.md). O projeto é mantido pela [Profy](https://www.profy.ai/), empresa que opera produtos baseados em LLMs sobre a BNCC. O código é licenciado sob MIT e os dados sob CC BY 4.0, em arquivos de licença separados. O nome "bncc.dev" e a identidade visual não são licenciados.