🇧🇷 IBGE MCP Server

Servidor MCP (Model Context Protocol) para as APIs públicas do IBGE, permitindo que agentes de IA como Claude acessem dados estatísticos, geográficos e econômicos do Brasil em tempo real.

✨ Versão 2.2.0 — Agora com suporte HTTP/SSE, cache inteligente, API de Nomes e suporte multi-variável!

Sponsored by Aeon Bridge Co. 🌉 Building the future of AI-powered data integration. Contact: contact@aeonbridge.com

✨ Ferramentas Disponíveis (27+ tools)

📍 Localidades

📊 SIDRA (Sistema de Recuperação Automática)

📈 Indicadores Econômicos

👥 Censo e População

🏷️ API de Nomes (Censo)

🗺️ Malha e Notícias

Related MCP server: mcp-brasil

🚀 Instalação

Instalação via npm (Recomendado)

# Instale globalmente via npm
npm install -g ab-ibge-mcp-server

Instalação manual (Desenvolvimento)

# 1. Clone ou copie o projeto
cd ibge-mcp-server

# 2. Instale as dependências
npm install

# 3. Compile o TypeScript
npm run build

# 4. Teste o servidor
node dist/index.js

🌐 Modos de Transporte

O servidor suporta dois modos de transporte:

Modo HTTP (Novo!)

Para usar o servidor via HTTP/SSE em vez de stdio:

# Desenvolvimento
npm run dev:http

# Produção
npm run start:http

# Customizar porta
MCP_TRANSPORT=http PORT=8080 npm start

Endpoints disponíveis:

• GET /health — Health check

• POST /sse — Conexão MCP via Server-Sent Events

📖 Documentação completa: HTTP_MODE.md

⚙️ Configuração no Claude Desktop

Se instalou via npm global

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ibge": {
      "command": "ab-ibge-mcp-server"
    }
  }
}

Se instalou manualmente

{
  "mcpServers": {
    "ibge": {
      "command": "node",
      "args": ["/caminho/para/ibge-mcp-server/dist/index.js"]
    }
  }
}

Reinicie o Claude Desktop. O ícone 🔌 aparecerá indicando que o servidor está conectado.

💡 Exemplos de Uso com Agentes IA

Usuário: "Qual o estado mais populoso do Brasil?"
Agente: ibge_populacao_estados() → São Paulo com 44,4 milhões de habitantes (21,7% do total)

Usuário: "Quantas pessoas se chamam Maria no Brasil?"
Agente: ibge_nomes_frequencia(nome="Maria") → 11,7 milhões de pessoas registradas

Usuário: "Quais os nomes masculinos mais populares na década de 1990?"
Agente: ibge_nomes_ranking(sexo="M", decada=1990) → Top 20 com frequência

Usuário: "Qual o PIB de São Paulo em 2021?"
Agente: ibge_pib_estados(ano=2021, uf_id=35) → R$ 2,7 trilhões (31% do PIB nacional)

Usuário: "População estimada do Brasil em 2024"
Agente: ibge_estimativas_populacionais(ano=2024, localidade="BR") → 212,6 milhões

Usuário: "Compare inflação de 2023 e 2024 mês a mês"
Agente: ibge_indicador_economico(indicador="IPCA", periodos="202301-202412")

Usuário: "Liste todas as cidades de SC com 'Floriano' (sem acento)"
Agente: ibge_listar_municipios(uf="SC", busca="Floriano") → Florianópolis encontrada!

Usuário: "Busque 'Sao Paulo' (sem acento)"
Agente: ibge_buscar_municipio(nome="Sao Paulo") → São Paulo-SP encontrado (normalização automática)

Usuário: "Qual a densidade demográfica do DF vs SP?"
Agente: ibge_densidade_demografica() → DF: 529.2 hab/km², SP: 177.3 hab/km²

Usuário: "Consulte IPCA e INPC simultaneamente"
Agente: ibge_sidra_consultar_tabela(tabela="1419", variaveis="63|44") → Múltiplas variáveis em uma chamada

🔧 Tecnologias e Performance

• TypeScript com tipagem estrita

• MCP SDK (@modelcontextprotocol/sdk)

• APIs do IBGE — 100% públicas, sem autenticação necessária

• Zod para validação de inputs

• Cache in-memory com TTL inteligente (até 7 dias para dados imutáveis)

• Retry automático com exponential backoff para maior confiabilidade

• Busca sem acentos — aceita "Sao Paulo", "Florianopolis", etc.

📚 APIs do IBGE Utilizadas

🤝 Sponsorship

This project is proudly sponsored by Aeon Bridge Co. 🌉

Aeon Bridge Co. is a technology company focused on building innovative solutions for AI-powered data integration and intelligent systems. We bridge the gap between complex data sources and modern AI agents, making information accessible and actionable.

Learn more: https://aeonbridge.com Contact: contact@aeonbridge.com

📄 License

MIT License - See LICENSE file for details.

🙏 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Made with ❤️ by the Aeon Bridge team