Skip to main content
Glama
mcp-brasil

mcp-brasil

by lucianoon

mcp-brasil

ブラジルの公開データをAIアシスタント向けツールとして公開するMCP(Model Context Protocol)サーバーです。Claude Desktop、Claude Code、Cursor、その他あらゆるMCPクライアントに対応しています。

利用可能なツール

ソース

Tools

説明

IBGE/SIDRA

ibge_populacao、ibge_pib、ibge_municipios、ibge_sidra

人口、GDP、自治体検索、および任意のSIDRA集計への汎用クエリ

中央銀行

bcb_serie、bcb_cambio、bcb_moedas、bcb_focus

SGS時系列(Selic、IPCAなど)、PTAX為替レート、通貨リスト、Focusレポートの期待値

INMET

inmet_estacoes、inmet_dados

気象観測所リストと観測された時間別データ(観測データにはトークンが必要)

下院

camara_deputados、camara_detalhes_deputado、camara_proposicoes、camara_votacoes_proposicao

連邦議員、立法提案、および投票

すべてのソースは公式のオープンAPIです。APIキーは不要ですが、 INMETの時間別データのみ例外です(下記参照)。

Related MCP server: ibge-data-mcp

インストール

要件: uv(またはpipを使用したPython 3.12+)。

git clone https://github.com/lucianoon/mcp-brasil
cd mcp-brasil
uv sync

設定

Claude Desktop / Cursor

設定ファイル(claude_desktop_config.json または mcp.json)に追加します:

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uv",
      "args": ["run", "--directory", "/caminho/para/mcp-brasil", "mcp-brasil"]
    }
  }
}

Claude Code

claude mcp add mcp-brasil -- uv run --directory /caminho/para/mcp-brasil mcp-brasil

オプションのINMETトークン

観測所の一覧(inmet_estacoes)は公開されています。一方、観測された時間別 データ(inmet_dados)にはINMETが提供するトークンが必要です。portal.inmet.gov.brで申請し、 MCPクライアントで環境変数を設定してください:

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uv",
      "args": ["run", "--directory", "/caminho/para/mcp-brasil", "mcp-brasil"],
      "env": { "INMET_TOKEN": "seu-token" }
    }
  }
}

トークンがなくても、他の13のツールは通常どおり動作します。

使用例

設定後、アシスタントに直接質問できます:

  • 「過去6ヶ月のIPCAはいくらですか?」

  • 「市場は今後の会合でSelicに何を期待していますか?」(Focusレポート)

  • 「X党のミナスジェライス州連邦議員は誰ですか?」

  • 「2022年のサンパウロの人口は?GDPは?」

  • 「ここ数日のPTAXドルはどうですか?」

  • 「2025年のメンタルヘルスに関する法案を検索してください」

  • 「アマゾナス州にはINMETの自動観測所がいくつありますか?」

開発

uv sync --dev
uv run pytest
uv run ruff check .
uv run mypy src

アーキテクチャ

src/mcp_brasil/
├── server.py        # Servidor MCP e registro das tools
├── http.py          # Cliente HTTP compartilhado, retry e tratamento de erros
├── cache.py         # Cache TTL em memória para as respostas das APIs
└── tools/
    ├── ibge.py      # SIDRA v3 + localidades v1
    ├── bcb.py       # SGS + Olinda (PTAX e Boletim Focus)
    ├── inmet.py     # Estações e dados observacionais
    └── camara.py    # Dados Abertos da Câmara v2
  • stdioトランスポート(MCPデスクトップ標準)

  • 同一リクエストに対する10分間のTTLキャッシュ

  • ネットワーク障害時の自動リトライ

  • モデルが読み取り可能なテキストとしてフォーマットされた出力

ロードマップ

  • v0.2 — INMET(観測所 + トークン付き観測データ)およびFocusレポート

  • DOU: 官報(Diário Oficial da União)の検索(安定した公開APIを待機中)

  • TSE: 選挙結果

  • PyPIへの公開(uvx mcp-brasil)

  • オプションのstreamable-httpトランスポート

ライセンス

MIT

Available Tools

14 tools
bcb_cambioA

Cotações de câmbio PTAX do Banco Central para uma moeda nos últimos N dias.

Args: moeda: Símbolo da moeda (ex.: "USD", "EUR", "GBP"). Use a tool bcb_moedas para listar as moedas disponíveis. dias: Quantidade de dias úteis de cotação a retornar (padrão 7).

Inputs: dias, moeda. Returns: result

bcb_focusB

Expectativas de mercado do Boletim Focus (Boletim Focus) do Banco Central.

Mostra a projeção média dos analistas de mercado para os próximos períodos.

Args: indicador: Um de: "selic", "ipca", "pib" ou "cambio".

Inputs: indicador. Returns: result

bcb_moedasA

Lista as moedas com cotação PTAX disponíveis no Banco Central.

Inputs: no named parameters. Returns: result

bcb_serieA

Consulta séries temporais do Sistema Gerenciador de Séries (SGS) do Banco Central.

Args: codigo: Código da série SGS. Exemplos: 1178 (Selic meta), 433 (IPCA mensal), 13522 (IPCA acumulado em 12 meses), 4390 (CDI), 36 (salário mínimo), 189 (IGP-M), 206 (INPC). Catálogo: https://www3.bcb.gov.br/sgspub/ data_inicial: Data inicial ISO "AAAA-MM-DD". Padrão: últimos 90 dias. data_final: Data final ISO "AAAA-MM-DD". Padrão: hoje.

Inputs: codigo (required), data_final, data_inicial. Returns: result

camara_deputadosA

Lista deputados federais da Câmara com filtros opcionais.

Args: uf: Sigla da unidade federativa, ex.: "SP", "MG". partido: Sigla do partido, ex.: "PT", "PSDB". nome: Nome (total ou parcial) do parlamentar. legislatura: Número da legislatura (ex.: 57 para a atual). Padrão: atual.

Inputs: uf, nome, partido, legislatura. Returns: result

camara_detalhes_deputadoA

Detalhes de um deputado federal pelo ID: nome civil, partido, UF e gabinete.

Args: id_deputado: ID numérico do deputado (obtido via camara_deputados).

Inputs: id_deputado (required). Returns: result

camara_proposicoesB

Busca proposições legislativas na Câmara (projetos de lei, emendas etc.).

Args: ano: Ano de apresentação, ex.: 2025. palavras_chave: Palavras-chave na ementa, ex.: "saude mental". sigla_tipo: Sigla do tipo, ex.: "PL", "PEC", "MPV".

Inputs: ano, sigla_tipo, palavras_chave. Returns: result

camara_votacoes_proposicaoA

Lista as votações realizadas para uma proposição específica da Câmara.

Args: id_proposicao: ID numérico da proposição (obtido via camara_proposicoes).

Inputs: id_proposicao (required). Returns: result

ibge_municipiosA

Busca municípios brasileiros pelo nome (IBGE), com filtro opcional por UF.

Args: nome: Nome (total ou parcial) do município, ex.: "campinas". uf: Sigla opcional da UF para restringir a busca, ex.: "SP".

Inputs: nome (required), uf. Returns: result

ibge_pibA

PIB a preços correntes de uma unidade da federação ou do Brasil (IBGE/SIDRA).

Args: uf: Sigla da UF (ex.: "MG", "BA") ou "BR" para o total nacional. ano: Ano de referência. Se omitido, retorna o período mais recente disponível.

Inputs: uf, ano. Returns: result

ibge_populacaoA

População residente de uma unidade da federação ou do Brasil (IBGE/SIDRA).

Args: uf: Sigla da UF (ex.: "SP", "RJ") ou "BR" para o total nacional. ano: Ano de referência. Se omitido, retorna o período mais recente disponível.

Inputs: uf, ano. Returns: result

ibge_sidraA

Consulta genérica à API SIDRA do IBGE para qualquer indicador.

Args: agregado: ID do agregado SIDRA (ex.: "4709" população, "5938" PIB, "1737" inflação INPC). Consulte https://servicodados.ibge.gov.br/api/v3/agregados para a lista completa. variavel: ID da variável dentro do agregado (ex.: "93"). localidades: Filtro de localidades no formato SIDRA, ex.: "N1[1]" Brasil, "N3[35]" São Paulo (estado), "N6[3550308]" Campinas (município). periodos: Períodos, ex.: "-1" (último), "2022", "2020/2024".

Inputs: agregado (required), variavel (required), periodos, localidades. Returns: result

inmet_dadosA

Dados horários observados de uma estação automática do INMET (últimos dias).

Requer o ambiente INMET_TOKEN com token fornecido pelo INMET (solicite em https://portal.inmet.gov.br). Sem token, use inmet_estacoes.

Args: estacao: Código da estação, ex.: "A001". Liste códigos com inmet_estacoes. dias: Quantidade de dias retroativos a consultar (padrão 2, máximo 7).

Inputs: estacao (required), dias. Returns: result

inmet_estacoesA

Lista estações meteorológicas do INMET (não requer autenticação).

Args: tipo: "T" para estações automáticas ou "M" para convencionais. uf: Sigla opcional da UF para filtrar, ex.: "SP".

Inputs: uf, tipo. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., population vs PIB vs municipalities vs generic SIDRA), and within each source (IBGE, BCB, INMET, Camara) the functions are clearly separated—list vs details vs votes. There is no meaningful overlap that would cause an agent to misselect.

    Naming Consistency5/5

    All tools follow a consistent 'source_noun' pattern with snake_case (ibge_populacao, bcb_serie, inmet_estacoes, camara_deputados). The only slight variation is the use of singular vs plural nouns, but this is a natural linguistic choice and does not break the overall consistency.

    Tool Count5/5

    With 14 tools, the server is well-scoped for its purpose of aggregating Brazilian public data across four distinct domains. No tool feels redundant, and the count is within the optimal 3–15 range, striking a good balance between breadth and focus.

    Completeness4/5

    Each domain is reasonably covered: IBGE has core indicators plus generic SIDRA, BCB has time series, exchange rates, currency list, and market focus, INMET has stations and data (with token gate), and Camara offers deputies, details, propositions, and votes. Minor gaps exist (e.g., no Camara session coverage, no direct inflation series), but the generic SIDRA tool compensates for many potential lacks, and the core workflows are achievable.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects AI agents to 28 Brazilian public APIs, providing over 200 tools to access data on economy, legislation, transparency, and the judiciary. It enables complex queries and cross-referencing of government datasets like IBGE, the Central Bank, and the National Congress through natural language.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to query 153 live Brazilian government data tools across federal and state sources, including economy, legislature, judiciary, elections, health, education, and more, reading directly from original APIs.
      MIT