# 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:

```json
{
  "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.