BNCC MCP Server
Servidor MCP (Model Context Protocol) da BNCC e da BNCC Computação para uso em assistentes de IA.
URL oficial
- Base URL: https://bncc-mcp-server.vercel.app/
- Endpoint MCP: https://bncc-mcp-server.vercel.app/api/mcp
O que este servidor oferece
- Consulta estruturada de habilidades da BNCC comum (Educação Infantil + Ensino Fundamental)
- Consulta estruturada de habilidades da BNCC Computação
- Validação de código para evitar citação de habilidades inexistentes
- Taxonomia oficial para filtros (etapa, área, componente, ano, eixo etc.)
Conteúdo
- 1397 habilidades da BNCC comum
- 115 habilidades da BNCC Computação
Configuração rápida no VS Code (escopo de usuário)
Adicione no seu mcp.json de usuário:
{
"servers": {
"bncc": {
"type": "http",
"url": "https://bncc-mcp-server.vercel.app/api/mcp"
}
}
}Depois, recarregue a janela do VS Code.
Ferramentas (tools)
| Ferramenta | Quando usar |
|---|---|
| buscar_habilidades | Quando você quer encontrar habilidades por tema ou por filtros. |
| obter_habilidade | Quando você já tem um código e quer os dados completos da habilidade. |
| validar_codigo | Antes de citar qualquer código em plano, atividade ou relatório. |
| listar_taxonomia | Antes de aplicar filtros, para usar apenas valores válidos. |
Recursos (resources)
| URI | Quando usar |
|---|---|
| bncc://taxonomia | Para consultar rapidamente os valores válidos de filtro e totais. |
| bncc://habilidade/{codigo} | Para leitura direta de uma habilidade específica via URI. |
| bncc://geral | Para acesso ao conjunto completo da BNCC comum. |
| bncc://computacao | Para acesso ao conjunto completo da BNCC Computação. |
Exemplos de uso
- "Busque habilidades de Matemática para o 5º ano."
- "Valide o código EF06CO03 antes de usar no plano de aula."
- "Obtenha os detalhes da habilidade EF15LP03."
- "Liste os eixos de Computação disponíveis para filtro."
Boas práticas
- Sempre rode validar_codigo antes de citar códigos em materiais pedagógicos.
- Sempre consulte listar_taxonomia antes de aplicar filtros por texto livre.
- Em respostas para usuários finais, prefira citar código + descrição resumida.
Solução de problemas
- Erro 401 Protected deployment:
- Verifique se a proteção de deployment na Vercel está desativada para o projeto/ambiente.
- Sem resultado na busca:
- Confira filtros com listar_taxonomia e tente reduzir a quantidade de filtros.
- Endpoint não conecta:
- Confirme que está usando /api/mcp no final da URL.
Fontes dos dados
- BNCC (Educação Infantil e Ensino Fundamental)
- BNCC Computação (complemento)
Este servidor existe para reduzir alucinação de códigos e aumentar a confiabilidade no uso pedagógico da BNCC com IA.