agrobr

agrobr-mcp

为大模型提供实时巴西农业数据访问的 MCP 服务——可通过 agrobr 从 10 个公共来源获取价格、作物估算、气候、森林砍伐等数据。

---

安装

0.2.0 版本需要 agrobr >=2.0.0,<3 和 MCP Python SDK >=2.0.0,<3。

pip install agrobr-mcp

设置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "agrobr": {
      "command": "python",
      "args": ["-m", "agrobr_mcp"]
    }
  }
}

Cursor

设置 > MCP 服务 > 添加：

{
  "agrobr": {
    "command": "python",
    "args": ["-m", "agrobr_mcp"]
  }
}

Claude Code

claude mcp add agrobr python -- -m agrobr_mcp

如果上述操作因 -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

Docker

docker build -t agrobr-mcp .
docker run --rm -i agrobr-mcp

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "agrobr": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "agrobr-mcp"]
    }
  }
}

---

工具

开箱即用的 14 个工具：

价格与市场

工具	描述
preco_diario	农产品每日现货价格（CEPEA/ESALQ）
futuros_b3	B3 交易所农产品期货每日结算价格（默认采用最新发布的交易时段）
exportacao	按月份、产品和原产州汇总的农产品出口数据（Comex Stat；备用数据源为 ABIOVE）

生产与作物

工具	描述
estimativa_safra	按州查询作物估算，默认采用最新的有数据的种植季（CONAB/IBGE）
producao_anual	按州查询历史年度产量（IBGE PAM）
balanco	供需平衡——库存、消费、出口（CONAB）
progresso_safra	按州查询每周播种和收获进度（CONAB）
serie_historica_safra	按种植季查询历史作物系列数据——面积、产量、单产；默认查询最近 10 年（CONAB）
rebanho	按州查询牲畜存栏量和动物产品，默认采用最新发布的年份（IBGE PPM）

气候与环境

工具	描述
clima	按州查询气候数据——温度、降水、辐射（NASA POWER）
desmatamento	按生物群落查询森林砍伐多边形（前一个日历年的 PRODES；若无数据，则再回退一年）和预警（DETER，最近 15 天），可选按年份和州筛选，最多 2,000 条记录（INPE）
queimadas	按市镇和生物群落查询一天内的火点，参考卫星（INPE）

元信息

工具	描述
listar_produtos	列出各工具的有效产品
health_check	检查所有数据源的状态

---

示例查询

"Qual o preço da soja nos últimos 5 dias?"
"Estimativa de safra de milho por estado"
"Progresso da colheita de soja"
"Dados de desmatamento na Amazônia"
"Quais produtos estão disponíveis?"

---

工作原理

User (natural language)
    │
MCP Client (Claude Desktop / Cursor / Claude Code)
    │
agrobr-mcp (this server — thin layer, text formatting)
    │
agrobr library (data collection, parsing, caching)
    │
19 public APIs (CEPEA, CONAB, IBGE, INPE, B3, NASA POWER…)

agrobr-mcp 是一个轻量包装器。所有数据逻辑都在 agrobr 库中。

---

开发

git clone https://github.com/bruno-portfolio/agrobr-mcp.git
cd agrobr-mcp
pip install -e ".[dev]"

# Run tests
pytest tests/ -m "not integration" -v

# Lint
ruff check src/ tests/
ruff format src/ tests/

---

许可证

MIT

---

PT-BR

什么是 agrobr-mcp？

为大模型提供实时巴西农业数据访问的 MCP 服务。价格、种植季、气候、森林砍伐等数据，均来自 CEPEA、CONAB、IBGE、INPE 和 B3 等公共来源。

安装

0.2.0 版本需要 agrobr >=2.0.0,<3 和 MCP Python SDK >=2.0.0,<3。

pip install agrobr-mcp

配置

按照上述说明，将其添加到你的 MCP 客户端（Claude Desktop、Cursor 或 Claude Code）。

Docker

docker build -t agrobr-mcp .
docker run --rm -i agrobr-mcp

14 个可用工具

• preco_diario — 农产品现货价格（CEPEA/ESALQ）
• futuros_b3 — B3 农产品期货每日结算价（默认使用最新发布的交易日数据）
• exportacao — 按产品和原产州汇总的月度农产品出口（Comex Stat；备用数据源为 ABIOVE）
• estimativa_safra — 按州划分的作物产量估算（默认使用有数据的最新收成季；CONAB/IBGE）
• producao_anual — 按州划分的历史产量（IBGE PAM）
• balanco — 供需平衡表（CONAB）
• progresso_safra — 每周播种和收获进度（CONAB）
• serie_historica_safra — 按收成季划分的历史序列：面积、产量和单产；默认显示最近 10 年（CONAB）
• rebanho — 按州划分的畜群和畜牧业产量（默认使用最新发布年份；IBGE PPM）
• clima — 按州划分的气候数据（NASA POWER）
• desmatamento — 按生物群系提供毁林多边形（PRODES，使用当前年份的上一年；若无数据则再往前一年）和预警（DETER，最近 15 天），可选按年份和州筛选，最多 2,000 条记录（INPE）
• queimadas — 按市镇和生物群系划分的一日热点，参考卫星（INPE）
• listar_produtos — 按工具列出有效产品
• health_check — 数据源状态

链接

• agrobr library — 农业数据库
• MCP Protocol — Model Context Protocol

mcp-name: io.github.bruno-portfolio/agrobr