프로젝트 소개

저장소 bncc-pacotes는 브라질 초중등교육의 공식 데이터셋인 Base Nacional Comum Curricular(BNCC)에 대한 기계용 인터페이스를 제공합니다. [bncc-dados](https://github.com/bncc-dev/bncc-dados) 데이터셋에서 파생된 세 가지 출판물을 포함합니다: TypeScript/JavaScript용 npm 패키지(`@bncc/dados`), Python용 PyPI 패키지(`bncc`), AI 에이전트 통합용 MCP 서버(`@bncc/mcp`). 데이터 1,721개는 패키지에 직접 내장되어 런타임 의존성과 네트워크 접근이 불필요합니다. 쿼리는 사용자의 로컬 컴퓨터에서 실행됩니다. 데이터셋은 bncc-dados 저장소의 특정 커밋에서 동기화되며, 체크섬과 날짜 버전은 `dados/VERSAO.json`에 기록됩니다. API에는 코드(`EF67LP08` 등)로 조회하는 `porCodigo`/`por_codigo`, 과목·학년·실천으로 필터링하는 `habilidadesEF`/`habilidades_ef`, 텍스트 검색용 `buscar`/`buscar`, 코드를 단계·영역·역량·순서로 분해하는 `decodificar`/`decodificar`와 같은 기능이 포함되어 있습니다. MCP 서버는 아홉 가지 도구(`bncc_lookup`, `bncc_buscar`, `bncc_listar`, `bncc_decodificar`, `bncc_estatisticas`, `bncc_estrutura`, `bncc_progressao_ei`)를 노출하여 AI 에이전트가 각 응답에서 공식 출처를 참조하도록 합니다. 존재하지 않는 코드는 번호 체계의 합리적 간극에 관한 설명적 오류를 반환해 환각을 방지합니다. 서버는 `npx -y @bncc/mcp`로 로컬에서 실행하거나 `https://mcp.bncc.dev`에서 HTTP streamable 방식으로 API 키 없이 무료 접근이 가능합니다. npm과 PyPI 구현 간의 동질성은 매 커밋마다 테스트되는 "골드 쿼리"로 보장되며, [docs/paridade.md](docs/paridade.md)에 문서화되어 있습니다. 프로젝트는 [Profy](https://www.profy.ai/)(BNCC 기반 LLM 제품을 운영하는 기업)가 관리합니다. 코드는 MIT, 데이터는 CC BY 4.0 라이선스로 별도 파일에 저장되었으며, "bncc.dev"명칭과 시각적 정체성은 라이선스 대상이 아닙니다.