mcp-brasil

Servidor MCP (Model Context Protocol) que expone datos públicos brasileños como herramientas para asistentes de IA: Claude Desktop, Claude Code, Cursor y cualquier cliente MCP.

Herramientas disponibles

Todas las fuentes son APIs oficiales abiertas — ninguna clave de API necesaria, excepto los datos horarios del INMET (ver abajo).

Related MCP server: ibge-data-mcp

Instalación

Requisitos: uv (o Python 3.12+ con pip).

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

Configuración

Claude Desktop / Cursor

Agregue al archivo de configuración (claude_desktop_config.json o 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

Token opcional del INMET

El listado de estaciones (inmet_estacoes) es abierto. En cambio, los datos horarios observados (inmet_dados) requieren un token proporcionado por el INMET — solicítelo en portal.inmet.gov.br y configure la variable de entorno en el cliente MCP:

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

Sin el token, las demás 13 herramientas funcionan normalmente.

Ejemplos de uso

Después de configurar, pregunte directamente al asistente:

• "¿Cuál fue el IPCA de los últimos 6 meses?"

• "¿Qué espera el mercado para la Selic en las próximas reuniones?" (Boletim Focus)

• "¿Quiénes son los diputados federales de Minas Gerais del partido X?"

• "¿Cuál es la población de São Paulo en 2022? ¿Y el PIB?"

• "¿Cómo está el dólar PTAX en los últimos días?"

• "Busque proyectos de ley de 2025 sobre salud mental"

• "¿Qué estaciones automáticas del INMET existen en Amazonas?"

Desarrollo

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

Arquitectura

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

• Transporte stdio (estándar MCP de escritorio)

• Caché TTL de 10 minutos por solicitud idéntica

• Reintento automático en fallos de red

• Salidas formateadas como texto legible por el modelo

Hoja de ruta

• v0.2 — INMET (estaciones + observacional con token) y Boletim Focus

• DOU: búsqueda en el Diario Oficial de la Unión (esperando API pública estable)

• TSE: resultados electorales

• Publicación en PyPI (uvx mcp-brasil)

• Transporte streamable-http opcional

Licencia

MIT