mcp-brasil
mcp-brasil
브라질 공공 데이터를 AI 어시스턴트용 도구로 노출하는 MCP(Model Context Protocol) 서버: Claude Desktop, Claude Code, Cursor 및 모든 MCP 클라이언트.
사용 가능한 도구
소스 | Tools | 설명 |
IBGE/SIDRA |
| 인구, GDP, 지자체 검색 및 모든 SIDRA 집계에 대한 일반 조회 |
Banco Central |
| SGS 시계열(Selic, IPCA...), PTAX 환율, 통화 목록 및 Focus 보고서 전망 |
INMET |
| 기상 관측소 목록 및 시간별 관측 데이터(관측 데이터는 토큰 필요) |
Câmara dos Deputados |
| 국회의원, 입법 제안 및 투표 |
모든 소스는 공식 공개 API입니다 — INMET 시간별 데이터를 제외하고 API 키가 필요하지 않습니다(아래 참조).
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 v2stdio 전송(MCP 데스크톱 표준)
동일 요청에 대한 10분 TTL 캐시
네트워크 오류 시 자동 재시도
모델이 읽을 수 있는 텍스트로 형식화된 출력
로드맵
v0.2 — INMET(관측소 + 토큰 포함 관측) 및 Focus 보고서
DOU: 연방 관보 검색(안정적인 공개 API 대기 중)
TSE: 선거 결과
PyPI 게시(
uvx mcp-brasil)선택적 streamable-http 전송
라이선스
MIT
Available Tools
14 toolsbcb_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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Banco Central do Brasil (BCB): SGS series, Focus expectations, PTAX, stats + provenance. 17 tools.
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceConnects 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
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to access Brazilian IBGE statistical data (population, economy, agriculture) via natural language, with tools for querying aggregated data and metadata.-
- AlicenseAqualityDmaintenanceEnables AI agents to access Brazilian statistical, geographic, and economic data in real-time via IBGE public APIs.32MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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