用途
agrobr-mcp 是一个 MCP（Model Context Protocol）服务器，为 LLM 提供获取巴西农业实时数据的能力。它本身是一个轻量封装层（thin wrapper），所有数据处理逻辑都在 agrobr 库中实现，数据来自约 10 个公开来源，包括 CEPEA、CONAB、IBGE、B3、INPE 等，覆盖价格、作物估产、气候、森林砍伐与火灾等主题。
主要能力
该服务器开箱即用提供 14 个工具，按主题划分如下：
- 价格与市场：preco_diario（CEPEA/ESALQ 农产品现货价格）、futuros_b3（B3 农产品期货每日结算价，默认返回最近一个已发布交易日）、exportacao（按产品与来源州分月汇总的农产品出口，数据源 Comex Stat，ABIOVE 作为备用）。
- 生产与作物：estimativa_safra（按州作物估产，默认返回最近有数据的一季）、producao_anual（IBGE PAM 历史产量，按州）、balanco（CONAB 供需平衡表）、progresso_safra（CONAB 每周播种与收获进度）、serie_historica_safra（按季的历史序列：面积、产量与单产，默认最近 10 年）、rebanho（IBGE PPM 按州牲畜存栏与动物产品，默认最近公布年份）。
- 气候与环境：clima（NASA POWER 按州气候数据）、desmatamento（INPE 森林砍伐多边形： PRODES 取当前年份的前一年，若为空则再前推一年；以及 DETER 最近 15 天警报，可按生物群系筛选，可选年份与州过滤，最多 2,000 条记录）、queimadas（INPE 单日按市镇与生物群系的热点，参考卫星）。
- 辅助工具：listar_produtos（列出各工具支持的有效产品）、health_check（数据源状态）。
使用方式
版本 0.2.0 要求 agrobr >=2.0.0,<3 和 MCP Python SDK >=2.0.0,<3。在 MCP 客户端中配置方式为：Settings > MCP Servers > Add，并添加到 claude_desktop_config.json。
若因 -m 参数解析导致失败，可创建包装脚本：
- Linux/macOS：echo 'python -m agrobr_mcp' > run.sh && chmod +x run.sh && claude mcp add agrobr ./run.sh
- Windows：echo python -m agrobr_mcp > run.bat && claude mcp add agrobr run.bat
可接入 Claude Desktop、Cursor 或 Claude Code 等 MCP 客户端。示例查询（Example queries）可参考仓库说明。MCP 名称标识为 io.github.bruno-portfolio/agrobr。
适用场景
适用于在 LLM 对话或代理流程中查询巴西农业数据的场景，例如查看某州作物估产、跟踪播种与收获进度、查询农产品现货与期货价格、获取出口汇总、了解森林砍伐与火灾热点等。
限制
- 项目定位为封装层，数据逻辑均在 agrobr 库中。
- desmatamento 最多返回 2,000 条记录；PRODES 使用当前年份前一年数据，若为空再向前推一年；DETER 仅覆盖最近 15 天。
- 各工具默认时间范围与数据源已在描述中限定，具体可用产品需通过 listar_produtos 查询。
- 其他未在资料中说明的功能、收费或平台支持情况暂未提供。
