bncc-pacotes MCP server
Commit Oct 15, 2026Provides access to the Brazilian National Common Curricular Base (BNCC) dataset through MCP tools, npm, and PyPI packages for AI agents and developers.
Also known as bncc-dev/bncc-pacotes, @bncc/mcp
- Stars
- 10
- Tools
- —
- Downloads, 30 days
- 165
- Latest version
- —
- Last commit
- Oct 15, 2026
- License
- —
What is bncc-pacotes MCP?
bncc-pacotes provides access to the Brazilian National Common Curricular Base (BNCC) dataset through MCP tools, npm, and PyPI packages for AI agents and developers.
Summary generated from the project's README
About bncc-pacotes MCP server
Accessing the 1,721 learning objectives of the Brazilian National Common Curricular Base is what this server enables for developers and AI agents. It provides a verified interface to official educational data through seven specific tools, including bncc_lookup, bncc_buscar, and bncc_decodificar. Users can run the server locally using npx or connect to a hosted version via HTTP without needing an API key.
Developers can integrate these datasets into TypeScript or Python projects using dedicated npm and PyPI packages. The system is designed for local execution with zero network dependency for the embedded data, ensuring that queries happen directly on your machine. This approach prevents AI hallucinations by returning explicit errors for non-existent codes instead of null values. The server includes specialized tools like bncc_estatisticas and bncc_progressao_ei to provide structural insights and educational progression data.
What you can do with it
- 1Decode curriculum identifiersAn application can transform a curriculum code into its constituent parts like educational stage and area.
Written from the project's README. Every use case is checked against a quote from it.
How to install bncc-pacotes MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall bncc-pacotes MCP in Claude Code
$ claude mcp add bncc-pacotes -- npx -y @bncc/mcpInstall bncc-pacotes MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bncc-pacotes": {
"command": "npx",
"args": [
"-y",
"@bncc/mcp"
]
}
}
}Install bncc-pacotes MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bncc-pacotes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bncc/mcp"
]
}
}
}Install bncc-pacotes MCP in VS Code CLI
$ code --add-mcp '{"name":"bncc-pacotes","type":"stdio","command":"npx","args":["-y","@bncc/mcp"]}'Install bncc-pacotes MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"bncc-pacotes": {
"command": "npx",
"args": [
"-y",
"@bncc/mcp"
]
}
}
}Install bncc-pacotes MCP in Codex
$ codex mcp add bncc-pacotes -- npx -y @bncc/mcpInstall bncc-pacotes MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.bncc-pacotes] command = "npx" args = ["-y", "@bncc/mcp"]
Install bncc-pacotes MCP in Gemini CLI
$ gemini mcp add -s user bncc-pacotes npx -- -y @bncc/mcpInstall bncc-pacotes MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"bncc-pacotes": {
"command": "npx",
"args": [
"-y",
"@bncc/mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebncc-dev/bncc-pacotes is public and reachablegithub.com/bncc-dev/bncc-pacotes ↗Pass
- Package names this repository as its source@bncc/mcp names bncc-dev/bncc-pacotes as sourcenpmjs.com/package/@bncc/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-15github.com/bncc-dev/bncc-pacotes ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @bncc/mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubbncc.dev · pacotes, MCP e API de consulta
Português · English
A Base Nacional Comum Curricular (BNCC) consumível em uma linha de código. As
1.721 aprendizagens da educação básica brasileira, verificadas contra os
documentos oficiais do MEC/CNE, como pacote npm, pacote PyPI e servidor MCP para
agentes de IA. Dados embutidos e zero rede: a consulta acontece na sua
máquina. O @bncc/dados e o bncc (PyPI) não têm dependências de runtime; o
@bncc/mcp usa o SDK oficial do MCP (MIT) e o zod (MIT).
O dataset não nasce aqui, vem do bncc-dados. Este repositório são as interfaces para máquina desse dataset.
Uso rápido
npx -y @bncc/mcp # servidor MCP: a BNCC ao alcance do seu agente de IA
npm install @bncc/dados # TypeScript / JavaScript
pip install bncc # Python
TypeScript
import { porCodigo, habilidadesEF, buscar, decodificar } from '@bncc/dados';
const h = porCodigo('EF67LP08');
h.texto; // enunciado oficial verificado
h.organizacao.nomes.praticaLinguagem; // 'Leitura'
h.fonte.localizador_pdf; // 'Base-Nacional-Comum-Curricular-BNCC.pdf, página PDF 167'
habilidadesEF({ componente: 'LP', ano: 6, pratica: 'Leitura' }); // 37 habilidades
buscar('frações', { etapa: 'EF', componente: 'MA' }); // 22 resultados, por relevância
decodificar('EM13LGG103'); // { etapa: 'EM', area: 'LGG', competenciaEspecifica: 1, sequencia: 3, ... }
Python, a mesma semântica, na convenção de cada ecossistema:
from bncc import por_codigo, habilidades_ef, buscar, decodificar
por_codigo('EF67LP08')['texto']
habilidades_ef(componente='LP', ano=6, pratica='Leitura') # 37
decodificar('EI02TS01') # {'etapa': 'EI', 'campo_experiencias': 'TS', ...}
Que as duas respondam idêntico não é promessa: é testado a cada commit pelas mesmas consultas douradas.
Servidor MCP
Sete tools (bncc_lookup, bncc_buscar, bncc_listar, bncc_decodificar,
bncc_estatisticas, bncc_estrutura, bncc_progressao_ei) que dão ao agente a
BNCC verificada, com fonte oficial em cada resposta. Códigos inexistentes
recebem um erro que explica que um código bem formado ausente dos dados não
existe na BNCC, em vez de um null que convida à alucinação.
Local, sem instalação permanente:
{ "mcpServers": { "bncc": { "command": "npx", "args": ["-y", "@bncc/mcp"] } } }
Hospedado, sem instalação nenhuma e sem API key: https://mcp.bncc.dev
(streamable HTTP).
O servidor hospedado roda em Cloudflare Workers, com o código em
mcp-worker/, também sob MIT. As tools são as mesmas da versão
local, que não depende de nenhum serviço externo.
Quanto isso muda a resposta de um modelo está medido, com dados brutos publicados, no bncc-benchmark.
O que tem neste repositório
| Diretório | Publica | Versão |
|---|---|---|
packages/bncc |
npm @bncc/dados: dados embutidos + API tipada |
0.7.0 |
packages/mcp |
npm @bncc/mcp: o servidor MCP, via npx |
0.6.0 |
python/ |
PyPI bncc: a API equivalente em snake_case |
0.5.0 |
mcp-worker/ |
o mesmo MCP hospedado em mcp.bncc.dev (Cloudflare Workers) |
no ar |
Os dados embutidos são sincronizados de um commit específico do bncc-dados por
scripts/sincronizar-dados.mjs, com data-version e checksums registrados em
dados/VERSAO.json de cada pacote. Ninguém edita dados/ à mão.
O 1.0.0 dos três pacotes está condicionado à release dados-v1.0.0 do
bncc-dados, que traz a revisão pedagógica registrada.
O site (bncc.dev) e o worker do formulário de contato não vivem aqui: migraram para bncc-site em jul/2026. Fica neste repo o que compartilha o dataset: ver DECISOES.md D2.
Desenvolvimento
pnpm install && pnpm -r build && pnpm -r test # npm, MCP e worker
cd python && uv sync && uv run pytest # PyPI
Node 22+, pnpm (a versão vem do packageManager) e
uv. O CI roda exatamente esses dois blocos.
Antes de abrir PR, leia o CONTRIBUTING.md: a regra de ouro é
que o núcleo injetável (criarConsultas) é a única superfície de consulta, e
PRs que reimplementem lookup, busca ou decodificação são recusados mesmo
passando nos testes.
Documentação
| Documento | Para quê |
|---|---|
| docs/manual-rapido.md | A visão de quem consome os pacotes: receitas por caso de uso |
| docs/arquitetura.md | O desenho do monorepo, o fluxo de dados pinado e o núcleo injetável |
| docs/paridade.md | O contrato das consultas douradas que impede npm e PyPI de divergirem |
| docs/manutencao.md | Runbook: atualizar dados, mudar API, publicar, troubleshooting |
| DECISOES.md | As escolhas não óbvias e por quê |
| CHANGELOG.md | O que mudou em cada versão publicada |
| AGENTS.md | Regras para agentes de IA trabalhando neste repo |
O ecossistema
| Repositório | O que é |
|---|---|
| bncc-dados | O dataset: extração reprodutível, validada em CI, com proveniência por registro |
| bncc-pacotes | Este repo: npm, PyPI e MCP sobre o dataset |
| bncc-benchmark | Quanto os LLMs alucinam sobre a BNCC, e quanto o grounding resolve |
Quem mantém
O bncc.dev é mantido pela Profy Tecnologias Educacionais Ltda (CNPJ 53.669.787/0001-45, Brasília, Brasil), titular dos direitos sobre o código deste repositório. Responsável técnico: Marcos Roberto Martins de Oliveira.
A Profy opera produtos que usam LLMs sobre a BNCC; estes pacotes são a camada verificada que esses produtos consomem, publicada aberta para que qualquer um consuma a mesma coisa.
Licenças
Código MIT, dados embutidos CC BY 4.0, em arquivos separados porque o mesmo artefato publicado carrega as duas naturezas: LICENSE, LICENSE-CODIGO.md, LICENSE-DADOS.md.
O nome "bncc.dev" e a identidade visual não são licenciados: o código é livre, a marca não. Derivados não devem se apresentar como sendo o bncc.dev.
Segurança: SECURITY.md (não abra issue pública). Conduta: CODE_OF_CONDUCT.md.
bncc-pacotes MCP questions
How do I add bncc-pacotes MCP to Claude Code?
Run claude mcp add bncc-pacotes -- npx -y @bncc/mcp in your terminal. Add --scope user to make it available in every project.
How do I add bncc-pacotes MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the server require an internet connection to query the data?
No, the local version uses embedded data and performs queries on your machine with zero network dependency.
What tools are available in the MCP server?
The server provides seven tools: bncc_lookup, bncc_buscar, bncc_listar, bncc_decodificar, bncc_estatisticas, bncc_estrutura, and bncc_progressao_ei.