À propos du projet

Le dépôt bncc-pacotes fournit des interfaces machine pour la Base Nacional Comum Curricular (BNCC), le jeu de données officiel de l'éducation de base brésilienne. Il contient trois publications dérivées du jeu de données [bncc-dados](https://github.com/bncc-dev/bncc-dados) : un paquet npm (`@bncc/dados`) pour TypeScript/JavaScript, un paquet PyPI (`bncc`) pour Python et un serveur MCP (`@bncc/mcp`) pour l'intégration avec des agents IA. Les données (1 721 apprentissages) sont intégrées directement dans les paquets, éliminant les dépendances d'exécution et le besoin d'accès au réseau. La consultation s'effectue localement sur la machine de l'utilisateur. Le jeu de données est synchronisé à partir d'un commit spécifique du dépôt bncc-dados, avec des checksums et data-version enregistrés dans `dados/VERSAO.json`. L'API offre des fonctions telles que `porCodigo`/`por_codigo` pour la recherche par code (ex : `EF67LP08`), `habilidadesEF`/`habilidades_ef` pour filtrer par composante, année et pratique, `buscar`/`buscar` pour la recherche textuelle et `decodificar`/`decodificar` pour décomposer les codes en leurs parties constitutives (étape, domaine, compétence, séquence). Le serveur MCP expose sept outils (`bncc_lookup`, `bncc_buscar`, `bncc_listar`, `bncc_decodificar`, `bncc_estatisticas`, `bncc_estrutura`, `bncc_progressao_ei`) qui permettent aux agents IA d'interroger la BNCC avec une source officielle dans chaque réponse. Les codes inexistants renvoient des erreurs explicatives sur les lacunes légitimes de la numérotation, évitant les hallucinations. Le serveur peut être utilisé localement via `npx -y @bncc/mcp` ou accessible gratuitement à `https://mcp.bncc.dev` via HTTP streamable, sans clé API. La parité entre les implémentations npm et PyPI est garantie par des requêtes « dorées » testées à chaque commit, comme documenté dans [docs/paridade.md](docs/paridade.md). Le projet est maintenu par [Profy](https://www.profy.ai/), une entreprise qui exploite des produits basés sur des LLMs sur la BNCC. Le code est sous licence MIT et les données sous CC BY 4.0, dans des fichiers de licence séparés. Le nom « bncc.dev » et l'identité visuelle ne sont pas sous licence.