@mcpassure/mcp-cnes

🇧🇷 Português (BR) · 🇺🇸 English

@mcpassure/mcp-cnes

MCP server para consulta ao CNES — Cadastro Nacional de Estabelecimentos de Saúde

Permite que agentes de IA (Claude, GPT, Copilot, etc.) consultem dados oficiais do CNES/DATASUS: estabelecimentos de saúde, leitos, equipamentos, profissionais e serviços especializados em todos os ~5.570 municípios brasileiros.

Aviso: Os dados refletem o cadastro CNES do mês de referência da última sincronização e podem não corresponder à realidade operacional atual do estabelecimento. Execute mcp-cnes sync para atualizar.

Instalação em 1 comando

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "cnes": {
      "command": "npx",
      "args": ["-y", "@mcpassure/mcp-cnes"]
    }
  }
}

Claude Code / Cursor / VS Code

npx -y @mcpassure/mcp-cnes

Tools disponíveis

Tool	Descrição	Input principal
buscar_por_codigo_cnes	Estabelecimento pelo código CNES (7 dígitos)	codigoCnes
buscar_por_nome	Busca por nome fantasia ou razão social	nome, uf?
buscar_por_municipio	Lista estabelecimentos de um município IBGE	codigoIbge, tipo?
buscar_por_tipo	Filtra por tipo (hospital, UBS, UPA, etc.)	tipo, uf?
listar_profissionais	Profissionais vinculados a um estabelecimento	codigoCnes
listar_leitos	Leitos por tipo (UTI adulto/pediátrico/neonatal, clínico, etc.)	codigoCnes
listar_equipamentos	Equipamentos cadastrados no estabelecimento	codigoCnes
listar_servicos	Serviços especializados oferecidos	codigoCnes

Todas as tools retornam structuredContent com schema validável.

Prompts

Prompts MCP estruturados para análise de dados CNES:

Prompt	Descrição	Parâmetros principais
perfil_estabelecimento	Consolida perfil completo de um estabelecimento	codigo_cnes, flags de seções
mapear_rede_municipio	Mapeia rede de saúde de um município	municipio (código IBGE), uf?, tipo?
analisar_cobertura_uf	Analisa cobertura de estabelecimentos por UF	uf, agrupar_por

Resources

Resources MCP com dados de referência do domínio CNES:

URI	MIME	Conteúdo
cnes://tipos_estabelecimento	application/json	Taxonomia oficial de tipos com código e descrição
cnes://categorias_servicos	application/json	Categorias de serviços especializados
cnes://scope	text/markdown	Escopo do MCP, limitações e disclaimer (PT/EN)

Demo

🚧 Demo GIF em breve.

Sincronização do dataset

Os dados vêm do FTP DATASUS (fonte oficial). Para sincronizar:

# Requer: blast (conversor DBC proprietário DATASUS)
# macOS: brew install blast-datasus
# Ubuntu: apt install blast
# Windows: ver documentação

# Sincronizar São Paulo (ST, LT, EQ, PF, SR)
npx @mcpassure/mcp-cnes sync --uf SP --grupos ST,LT,EQ,PF,SR

# Sincronizar todos os estados (operação longa, ~30min por estado)
npx @mcpassure/mcp-cnes sync

# Forçar re-download mesmo se já sincronizado
npx @mcpassure/mcp-cnes sync --uf SP --force

Sem sincronização, as tools de leitos/equipamentos/profissionais/serviços retornam aviso de "dataset não sincronizado". A tool buscar_por_codigo_cnes usa fallback online (REST API Mapa da Saúde/TCU).

Casos de uso reais

Mapeamento de rede assistencial:

"Quais hospitais com UTI adulto existem em Campinas/SP?" → buscar_por_municipio("350950", "hospital") + listar_leitos por estabelecimento

Capacidade de leitos UTI por região:

"Qual a capacidade de UTI neonatal nos hospitais de Recife/PE?" → buscar_por_municipio("261160", "hospital") + listar_leitos filtrando UTI neonatal

Identificação de equipamentos:

"Quais estabelecimentos têm ressonância magnética em Fortaleza/CE?" → buscar_por_municipio("230440") + listar_equipamentos por estabelecimento

Verificação de estabelecimento:

"O CNES 2077485 é ativo? Que serviços oferece?" → buscar_por_codigo_cnes("2077485") + listar_servicos("2077485")

Dados de profissionais

Os dados de profissionais cadastrados no CNES são públicos e incluem nome, CBO (Classificação Brasileira de Ocupações) e tipo de vínculo. CPFs são sempre mascarados na resposta.

Uso responsável: Estes dados não devem ser usados para identificar pacientes ou para fins que violem a privacidade dos profissionais além do contexto assistencial para o qual foram publicados.

Compliance LGPD

• Nenhum dado pessoal identificável de pacientes é tratado em nenhuma camada
• Dados de profissionais são públicos no CNES/DATASUS por obrigação legal
• Repositório aberto, sem coleta de dados de uso
• Consulte SECURITY.md para reporte de vulnerabilidades

Masking de CPF (opt-in PII)

Por padrão, CPFs de profissionais são mascarados no formato ***.***.XXX-**, preservando apenas os dígitos 7–9. Este é o comportamento padrão (privacy-first).

Para ambientes internos que necessitem do CPF completo (ex: auditoria, reconciliação de cadastro):

MCPASSURE_LGPD_ALLOW_PII=cnes npx @mcpassure/mcp-cnes

Ou no claude_desktop_config.json:

{
  "mcpServers": {
    "cnes": {
      "command": "npx",
      "args": ["-y", "@mcpassure/mcp-cnes"],
      "env": {
        "MCPASSURE_LGPD_ALLOW_PII": "cnes"
      }
    }
  }
}

Atenção: Ao habilitar MCPASSURE_LGPD_ALLOW_PII=cnes, certifique-se de que o ambiente de execução tem controles de acesso adequados e que o uso está em conformidade com a LGPD (Lei 13.709/2018).

Catálogo MCPAssure Brasil

Este é parte do catálogo MCPAssure Brasil, que disponibiliza MCPs de qualidade para o ecossistema de saúde brasileiro:

• @mcpassure/mcp-anvisa-bulario — Bulário Eletrônico ANVISA
• @mcpassure/mcp-cnes — Cadastro Nacional de Estabelecimentos de Saúde ← você está aqui
• @mcpassure/mcp-tuss — Tabela TUSS / Rol ANS

Desenvolvimento

git clone https://github.com/mcpassure/monorepo
cd monorepo
pnpm install
pnpm --filter @mcpassure/mcp-cnes dev       # servidor MCP em modo desenvolvimento
pnpm --filter @mcpassure/mcp-cnes test      # testes unitários e de integração
pnpm --filter @mcpassure/mcp-cnes lint      # lint + format check
pnpm --filter @mcpassure/mcp-cnes typecheck # verificação de tipos

Veja CONTRIBUTING.md para guia de contribuição.

SAFE-MCP Mapping

Avaliação contra o framework SAFE-MCP (OpenSSF + LF + OpenID Foundation).

Ataques mitigados

ID	Ataque	Status	Como mitigamos
SAFE-T001	Tool Poisoning	✓ Mitigado	Schema Zod estrito em todos os inputs; parâmetros tipados
SAFE-T002	Indirect Prompt Injection	✓ Mitigado	structuredContent separado do texto livre; dados do DATASUS não contêm markup
SAFE-T003	Credential exposure	✓ Mitigado	Credenciais R2 apenas em Worker server-side; client não armazena secrets
SAFE-T004	PII leakage	✓ Mitigado	CPF mascarado por padrão (privacy-first); opt-in explícito para PII
SAFE-T005	Resource exhaustion	✓ Mitigado	Cache SQLite local, sem requests em runtime ao FTP DATASUS

Ataques NÃO mitigados (declaração honesta)

ID	Ataque	Por que não mitigado
SAFE-T010	Supply-chain attack	pnpm audit + Renovate; sem SBOM gerado ainda
SAFE-T011	LGPD violation por misconfiguration	MCPASSURE_LGPD_ALLOW_PII=cnes requer configuração consciente do usuário

Lethal Trifecta Declaration (Willison, 2025)

• Acesso a dados privados — ⚠ Parcial. Dados de profissionais CNES são públicos por lei, mas CPFs são dados pessoais. Mitigados com masking por default + opt-in explícito.
• Exposição a conteúdo não-confiável — ⚠ Parcial. Inputs validados por Zod; dados DATASUS são governamentais e considerados confiáveis.
• Capacidade de comunicação externa — ✗ Ausente. MCP opera apenas sobre DB local; sem chamadas externas em runtime.

Conclusão: Fator #1 é parcial e gerenciado — não completa o trifecta. CNES é o MCP com maior atenção à privacidade da suíte MCPAssure.