agrobr

agrobr-mcp

LLM にブラジルの農業関連リアルタイムデータへのアクセスを提供する 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

Settings > MCP Servers > Add:

{
  "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、空の場合はさらに 1 年前にフォールバック) とアラート (DETER、直近 15 日間) をバイオーム別に取得。任意で年および州のフィルターを指定でき、最大 2,000 件 (INPE)
queimadas	自治体およびバイオーム別のある 1 日の火災ホットスポット。参照衛星 (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

O que é o agrobr-mcp?

Servidor MCP que dá acesso a dados agrícolas brasileiros em tempo real para LLMs. Preços, safras, clima, desmatamento e mais — tudo de fontes públicas como CEPEA, CONAB, IBGE, INPE e B3.

Instalação

A versão 0.2.0 requer agrobr >=2.0.0,<3 e MCP Python SDK >=2.0.0,<3.

pip install agrobr-mcp

Configuração

Adicione ao seu client MCP (Claude Desktop, Cursor ou Claude Code) conforme as instruções acima.

Docker

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

利用可能な14のツール

• preco_diario — 農産物コモディティのスポット価格（CEPEA/ESALQ）
• futuros_b3 — B3における農産物先物の日次調整値（デフォルトでは、公開された直近の取引日）
• exportacao — 農産物輸出を月別、製品別、原産UF別に集計（Comex Stat、予備としてABIOVE）
• estimativa_safra — UF別の作況推定、デフォルトではデータのある最新作季（CONAB/IBGE）
• producao_anual — UF別の過去の生産量（IBGE PAM）
• balanco — 需給バランス（CONAB）
• progresso_safra — 播種と収穫の週次進捗（CONAB）
• serie_historica_safra — 作季別の時系列：面積、生産量、生産性、デフォルトでは直近10年分（CONAB）
• rebanho — UF別の家畜頭数と畜産物生産、デフォルトでは公開された直近年（IBGE PPM）
• clima — UF別の気候データ（NASA POWER）
• desmatamento — 森林破壊ポリゴン（前年のPRODES、空の場合はさらに1年遡及）およびアラート（DETER、直近15日間）をバイオーム別に取得、年とUFの任意フィルター付き、最大2,000件（INPE）
• queimadas — 自治体およびバイオーム別の1日あたりの熱源点、参照衛星（INPE）
• listar_produtos — ツールごとに有効な製品を一覧表示
• health_check — データソースのステータス

リンク

• agrobr library — 農業データライブラリ
• MCP Protocol — Model Context Protocol

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