Skip to main content
Glama
deenesjakoptruzh
lucianoon

mcp-brasil

by lucianoon
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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 집계에 대한 일반 조회

Banco Central

bcb_serie, bcb_cambio, bcb_moedas, bcb_focus

SGS 시계열(Selic, IPCA...), PTAX 환율, 통화 목록 및 Focus 보고서 전망

INMET

inmet_estacoes, inmet_dados

기상 관측소 목록 및 시간별 관측 데이터(관측 데이터는 토큰 필요)

Câmara dos Deputados

camara_deputados, camara_detalhes_deputado, camara_proposicoes, camara_votacoes_proposicao

국회의원, 입법 제안 및 투표

모든 소스는 공식 공개 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 v2

  • stdio 전송(MCP 데스크톱 표준)

  • 동일 요청에 대한 10분 TTL 캐시

  • 네트워크 오류 시 자동 재시도

  • 모델이 읽을 수 있는 텍스트로 형식화된 출력

로드맵

  • v0.2 — INMET(관측소 + 토큰 포함 관측) 및 Focus 보고서

  • DOU: 연방 관보 검색(안정적인 공개 API 대기 중)

  • TSE: 선거 결과

  • PyPI 게시(uvx mcp-brasil)

  • 선택적 streamable-http 전송

라이선스

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • mcp-brasil

    PkLavc
    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.

  • ibge-data-mcp

    fmmarmello
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to access Brazilian IBGE statistical data (population, economy, agriculture) via natural language, with tools for querying aggregated data and metadata.

  • mcp-brasilapi

    silasrm
    A
    license
    A
    quality
    C
    maintenance
    Exposes the BrasilAPI as MCP tools, enabling AI agents to query Brazilian public data such as CEP, CNPJ, DDD, IBGE, banks, PIX, FIPE, NCM, exchange rates, taxes, weather, CVM information, holidays, ISBN, domains, stock tickers, and TUSS.
    41
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • Losbeto — Market Data for AI Agents

    Cross-asset market data for AI agents: forex, equities, Brazil macro (BCB/B3), crypto.

  • Banco MCP

    Brazilian Open Finance MCP — 30+ banks (Itaú, Nubank, etc.) to Claude/Cursor. Read-only.

  • Sugra API

    Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lucianoon/mcp-brasil'

If you have feedback or need assistance with the MCP directory API, please join our Discord server