MCP Server Brasil

MCP-сервер для 39 публичных API Бразилии.

Подключает AI-агентов (Claude, GPT, Copilot и др.) к государственным данным Бразилии: экономика, законодательство, прозрачность бюджета, судебные дела, выборы, экология, здравоохранение, безопасность и не только.

• 309 инструментов (tools), 80 ресурсов, 62 промпта — покрытие 14 тематических областей.
• 36 API не требуют ключей; для 3 нужна бесплатная регистрация (занимает 1 минуту).

Установка

pip install mcp-brasil
# или
uv add mcp-brasil

Быстрый старт

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
      "env": {
        "TRANSPARENCIA_API_KEY": "ваш-ключ",
        "DATAJUD_API_KEY": "ваш-ключ",
        "META_ACCESS_TOKEN": "ваш-токен"
      }
    }
  }
}

Ключи необязательны — без них работают 36 из 39 API.

VS Code / Cursor

Создайте .vscode/mcp.json в корне проекта:

{
  "servers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": ["--from", "mcp-brasil", "python", "-m", "mcp_brasil.server"],
      "env": {
        "TRANSPARENCIA_API_KEY": "...",
        "DATAJUD_API_KEY": "...",
        "META_ACCESS_TOKEN": "..."
      }
    }
  }
}

Claude Code

claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server

HTTP (другие MCP-клиенты)

fastmcp run mcp_brasil.server:mcp --transport http --port 8000
# Сервер доступен по адресу http://localhost:8000/mcp

Использование (примеры)

После подключения задавайте вопросы на естественном языке:

• Законодательство: «Какие законопроекты об искусственном интеллекте рассматривались в Палате депутатов в 2024 году? Кто авторы?»
• Экономика: «Какова динамика ставки Selic за последние 12 месяцев? Сравните с инфляцией (IPCA) за тот же период.»
• Прозрачность: «Назовите 10 крупнейших контрактов федерального правительства в 2024 году и их поставщиков.»
• Перекрёстный анализ: «Сравните подушевые расходы на здравоохранение в Сан-Паулу и Минас-Жерайс, используя данные TCE-SP и IBGE.»
• Судебная система: «Найдите процессы о нечестных торгах в TCU. Какие наказания были применены?»
• Выборы: «Кто крупнейшие спонсоры кампании кандидата X? Какова общая сумма сборов?»

Источники данных

Сервер объединяет API из 14 категорий (все ключи опциональны, кроме 3):

• Экономика и финансы: Bacen (Selic, IPCA, курс валют, ВВП), BNDES (финансирование).
• География и статистика: IBGE (штаты, муниципалитеты, имена, агрегированные данные).
• Законодательная власть: Câmara dos Deputados, Senado Federal (депутаты, законопроекты, голосования, расходы).
• Прозрачность и контроль: Portal da Transparência (контракты, расходы, госслужащие, санкции), TCU, TCE (10+ штатов — расходы муниципалитетов).
• Судебная власть: DataJud/CNJ (судебные процессы), STF, STJ, TST (юриспруденция).
• Выборы: TSE (кандидаты, доходы), Meta Ad Library (политическая реклама).
• Экология: INPE (очаги пожаров, вырубка лесов), ANA (гидрология).
• Здравоохранение: CNES/DataSUS (медучреждения), ANVISA (лекарства), OpenDataSUS (открытые данные).
• Общественная безопасность: Fórum Brasileiro de Segurança Pública (насилие, преступность).
• Госзакупки: PNCP + ComprasNet (тендеры, контракты), TransfereGov (бюджетные трансферты).
• Открытые данные и утилиты: BrasilAPI (CEP, CNPJ, банки), Dados Abertos (каталог), Querido Diário (официальные газеты), Tábua de Marés (приливы).

Полный каталог всех 309 инструментов доступен в документации по функциям.

Мета-инструменты

В дополнение к 309 инструментам данных, сервер предоставляет 4 мета-инструмента:

• listar_features — список всех доступных функций.
• recomendar_tools — рекомендация инструментов под задачу.
• planejar_consulta — создание плана выполнения, комбинирующего несколько API (например, расходы депутата + голосования + законопроекты).
• executar_lote — параллельный запуск нескольких запросов одним вызовом.

Также доступен Smart Discovery (на основе BM25): фильтрация 309 инструментов, показывающая только релевантные текущему запросу.

Ключи API (3 необязательных)

Переменные окружения (или .env): TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, META_ACCESS_TOKEN.

Конфигурация

Разработка

Проект использует архитектуру Package by Feature с Auto-Registry: каждая функция — это отдельная папка, которая подключается автоматически.

git clone https://github.com/jxnxts/mcp-brasil.git
cd mcp-brasil
make dev          # Установка зависимостей
make test         # Запуск всех тестов
make test-feature F=ibge  # Тесты одной функции
make ci           # Полная проверка (линтер + типы + тесты)

Чтобы добавить новую API, создайте директорию в src/mcp_brasil/data/ по шаблону — сервер подхватит её автоматически.

Лицензия

MIT.

Все данные получены из официальных государственных API. Сервер не генерирует и не изменяет данные.