mcp-brasil

Сервер MCP (Model Context Protocol), который предоставляет публичные данные Бразилии как инструменты для ИИ-ассистентов: Claude Desktop, Claude Code, Cursor и любой MCP-клиент.

Доступные инструменты

Все источники — официальные открытые API — никаких ключей API не требуется, кроме почасовых данных INMET (см. ниже).

Related MCP server: ibge-data-mcp

Установка

Требования: uv (или Python 3.12+ с pip).

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 инструментов работают нормально.

Примеры использования

После настройки спросите напрямую у ассистента:

• "Каким был IPCA за последние 6 месяцев?"

• "Чего рынок ожидает от Selic на ближайших заседаниях?" (Boletim Focus)

• "Кто федеральные депутаты от Минас-Жерайс от партии X?"

• "Какое население Сан-Паулу в 2022 году? А ВВП?"

• "Как обстоит курс доллара 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 desktop)

• Кэш TTL 10 минут для идентичных запросов

• Автоматические повторные попытки при сбоях сети

• Выходные данные, отформатированные как читаемый моделью текст

Дорожная карта

• v0.2 — INMET (станции + наблюдательные данные с токеном) и Boletim Focus

• DOU: поиск в Официальном вестнике Союза (ожидание стабильного публичного API)

• TSE: результаты выборов

• Публикация на PyPI (uvx mcp-brasil)

• Опциональный транспорт streamable-http

Лицензия

MIT