🇧🇷 IBGE MCP服务器
MCP（Model Context Protocol）服务器 IBGE 公共 API它允许像Claude这样的人工智能代理人实时访问巴西的统计，地理和经济数据。
✨ 版本 2.2.0 - 现在支持HTTP / SSE，智能缓存，名称API和多变量支持！
______________________________________________________________________
赞助 永旺大桥有限公司。 🌉 构建人工智能驱动的数据集成的未来。 联系人： contact@aeonbridge.com
______________________________________________________________________
✨ 可用工具 （27+ tools）
📍 地点
| 工具 | 描述 |
|---|---|
ibge_listar_regioes 列出5个地理区域及其州 | |
ibge_listar_estados 列出所有27个州的缩写，ID和地区。 | |
ibge_listar_municipios | 一个州的市镇列表（灵活搜索，无重音） |
ibge_buscar_municipio 按名称搜索整个巴西的城市（支持“圣保罗”） |
📊 SIDRA（自动恢复系统）
| 工具 | 描述 |
|---|---|
ibge_sidra_pesquisar_tabelas 按主题搜索表格（例如：“GDP”，“农业”） | |
ibge_sidra_metadados_tabela 表格元数据（变量、周期、位置） | |
ibge_sidra_consultar_tabela 查询数据与 多个变量 同时 。 | |
ibge_periodos_tabela | 列出表中的可用期 |
ibge_ipca IPCA历史系列月度通货膨胀 | |
ibge_pib_municipios | 市政GDP（表5938） |
ibge_pib_estados | 新的 国家GDP排名。 |
📈 经济指标
| 工具 | 描述 |
|---|---|
ibge_indicador_economico | IPCA， 累计IPCA， 失业， 收入， INPC |
ibge_listar_indicadores 列出所有可用的指标。 |
👥 人口普查和人口
| 工具 | 描述 |
|---|---|
ibge_populacao_municipio 按照2022年人口普查的城市人口 | |
ibge_populacao_estados 所有州的人口排名 | |
ibge_densidade_demografica | 人口密度（hab/km²） |
ibge_populacao_censo2022 | 具有高级过滤器的人口普查数据 |
ibge_estimativas_populacionais | 新的 — 市镇和州的年度估计（2001-2024+） |
🏷️ API 名称（人口普查）
| 工具 | 描述 |
|---|---|
ibge_nomes_frequencia | 新的 一个名字（例如“约翰”）的历史频率 |
ibge_nomes_ranking | 新的 — 巴西或UF最受欢迎的20个名字 |
🗺️ 网格和新闻
| 工具 | 描述 |
|---|---|
ibge_malha_geografica | URL da malha geográfica（GeoJSON/SVG） |
ibge_noticias | IBGE的新闻和发布 |
🚀 安装
通过 npm 安装 （推荐）
# Instale globalmente via npm
npm install -g ab-ibge-mcp-server手动安装（开发）
# 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🌐 运输方式
服务器支持两种传输模式 ：
| 模式 | 使用 | 命令 |
|---|---|---|
| 标准 （默认） | 本地使用 Claude Desktop， CLI | npm start |
超文本传输协议 部署云，多个客户端 npm run start:http |
HTTP模式（新增！）
要通过 HTTP/SSE 而不是 stdio 使用服务器：
# Desenvolvimento
npm run dev:http
# Produção
npm run start:http
# Customizar porta
MCP_TRANSPORT=http PORT=8080 npm start可用的端点 ：
GET /health--健康检查POST /sse--Conexão MCP通过服务器发送事件
📖 完整文档 ： HTTP_MODE.md
______________________________________________________________________
⚙️ Claude 桌面配置
通过npm global安装
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"ibge": {
"command": "ab-ibge-mcp-server"
}
}
}手动安装
{
"mcpServers": {
"ibge": {
"command": "node",
"args": ["/caminho/para/ibge-mcp-server/dist/index.js"]
}
}
}重新启动 Claude Desktop。图标🔌 显示服务器已连接。
💡 使用 AI 代理的示例
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🔧 技术与性能
- TypeScript 严格打字
- MCP-SDK （@modelcontextprotocol/sdk）
- IBGE 的 API 100%公开，无需身份验证
- 萨德 用于验证输入
- 缓存在内存中 具有智能TTL（不变数据长达7天）
- 自动重试 具有指数式备份以提高可靠性
- 无重音搜索 — 接受“圣保罗”，“佛罗里亚诺波利斯”等。
📚 使用的IBGE API
| API | 版本 | Endpoint Base |
|---|---|---|
| 位置 | v1 | servicodados.ibge.gov.br/api/v1/localidades |
| SIDRA | v3 | servicodados.ibge.gov.br/api/v3/agregados |
| 地理网格 | v2 | servicodados.ibge.gov.br/api/v2/malhas |
| 新闻 | v3 | servicodados.ibge.gov.br/api/v3/noticias |
🤝 赞助
这个项目很自豪 主办单位 永旺大桥有限公司。 🌉
Aeon Bridge Co.是一家专注于为人工智能数据集成和智能系统构建创新解决方案的技术公司。我们弥合了复杂数据源和现代人工智能代理之间的差距，使信息变得可访问和可操作。
了解更多： https://aeonbridge.com 联系人： contact@aeonbridge.com
______________________________________________________________________
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🙏 贡献
欢迎投稿！请随时提交问题或拉取请求。
______________________________________________________________________
由以下材料制成❤️ Aeon Bridge团队