mcp-brasil

MCP-Server (Model Context Protocol), der öffentliche brasilianische Daten als Werkzeuge für KI-Assistenten bereitstellt: Claude Desktop, Claude Code, Cursor und jeder MCP-Client.

Verfügbare Werkzeuge

Alle Quellen sind offizielle offene APIs – kein API-Schlüssel erforderlich, außer für die stündlichen INMET-Daten (siehe unten).

Related MCP server: ibge-data-mcp

Installation

Voraussetzungen: uv (oder Python 3.12+ mit pip).

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

Konfiguration

Claude Desktop / Cursor

Fügen Sie zur Konfigurationsdatei hinzu (claude_desktop_config.json oder 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

Optionales INMET-Token

Die Auflistung der Stationen (inmet_estacoes) ist offen. Die beobachteten stündlichen Daten (inmet_dados) erfordern jedoch ein vom INMET bereitgestelltes Token – fordern Sie es unter portal.inmet.gov.br an und konfigurieren Sie die Umgebungsvariable im MCP-Client:

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

Ohne das Token funktionieren die übrigen 13 Werkzeuge normal.

Anwendungsbeispiele

Nach der Konfiguration fragen Sie den Assistenten direkt:

• "Wie hoch war der IPCA der letzten 6 Monate?"

• "Was erwartet der Markt für die Selic bei den nächsten Sitzungen?" (Boletim Focus)

• "Wer sind die Bundesabgeordneten von Minas Gerais der Partei X?"

• "Wie hoch ist die Bevölkerung von São Paulo im Jahr 2022? Und das BIP?"

• "Wie steht der PTAX-Dollar in den letzten Tagen?"

• "Suchen Sie nach Gesetzesentwürfen von 2025 zum Thema psychische Gesundheit"

• "Welche automatischen INMET-Stationen gibt es in Amazonas?"

Entwicklung

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

Architektur

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-Transport (MCP-Desktop-Standard)

• TTL-Cache von 10 Minuten pro identischer Anfrage

• Automatische Wiederholung bei Netzwerkfehlern

• Ausgaben als für das Modell lesbarer Text formatiert

Roadmap

• v0.2 – INMET (Stationen + Beobachtungsdaten mit Token) und Boletim Focus

• DOU: Suche im Diário Oficial da União (wartet auf stabile öffentliche API)

• TSE: Wahlergebnisse

• Veröffentlichung auf PyPI (uvx mcp-brasil)

• Optionaler streamable-http-Transport

Lizenz

MIT