用途:mcp-brasil-server 是面向 AI 智能体的 MCP 服务器,把 70 多个巴西公共 API 封装为 533 个工具,便于查询政府、经济、立法、透明度、司法、选举、环境、健康、教育等数据。
主要能力:覆盖经济(Banco Central、IBGE)、立法(Câmara、Senado)、透明度(Portal da Transparência、TCU)、司法(DataJud、STF)、选举(TSE)、环境(INPE、IBAMA)、健康(DataSUS、ANVISA)、教育(INEP)等。多数 API 无需认证,仅 4 项功能需免费 API 密钥。内置 BM25 搜索按上下文过滤工具,提供 planejar_consulta 跨 API 规划与 executar_lote 批量并行执行。支持 DuckDB 本地数据集缓存(TSE 选举、SPU 房产、ANP 油价、INEP 学校普查等),首次加载需下载数据,后续查询为毫秒级。
使用方式:安装可用 pip install mcp-brasil 或 uv add mcp-brasil。Claude Desktop 在 claude_desktop_config.json 中配置 uvx --from mcp-brasil python -m mcp_brasil.server;VS Code/Cursor 创建 .vscode/mcp.json;Claude Code CLI 使用 claude mcp add mcp-brasil -- uvx --from mcp-brasil python -m mcp_brasil.server;HTTP 模式运行 fastmcp run mcp_brasil.server:mcp --transport http --port 8000。可选环境变量包括 TRANSPARENCIA_API_KEY、DATAJUD_API_KEY、META_ACCESS_TOKEN 和 MCP_BRASIL_DATASETS。
适用场景:查询经济指标、立法提案与议员支出、联邦合同与公务员薪资、法院判决、选举候选人及资产、健康设施与疫苗接种、野火热点、地理统计、油价与学校普查等。
限制:项目为独立项目,与巴西政府无隶属关系;各数据源有各自许可条款,商业或新闻用途前需阅读 ACCEPTABLE_USE.md;数据集下载可能达 100MB-1.6GB,首次加载耗时数分钟;部分功能需申请免费密钥;SQL 查询需先获取 schema。