Agrobr MCP

🚀 agrobr-mcp

agrobr-mcp 是一個MCP服務器，它能讓大語言模型（LLMs）訪問即時的巴西農業數據，這些數據涵蓋了價格、作物預估、氣候、森林砍伐等多個方面，數據來源於10個公開數據源。

🚀 快速開始

安裝

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"]
    }
  }
}

✨ 主要特性

agrobr-mcp 提供了10種工具，可分為以下幾類：

價格與市場

生產與作物

氣候與環境

元數據

💻 使用示例

以下是一些示例查詢：

"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]"

# 運行測試
pytest tests/ -m "not integration" -v

# 代碼檢查
ruff check src/ tests/
ruff format src/ tests/

📄 許可證

本項目採用 MIT 許可證。

🇵🇹 葡萄牙語說明

什麼是 agrobr-mcp？

agrobr-mcp 是一個 MCP 服務器，它能讓大語言模型（LLMs）訪問即時的巴西農業數據。這些數據包括價格、作物、氣候、森林砍伐等，所有數據都來自 CEPEA、CONAB、IBGE、INPE 和 B3 等公開數據源。

安裝

pip install agrobr-mcp

配置

按照上述說明將其添加到您的 MCP 客戶端（Claude Desktop、Cursor 或 Claude Code）中。

Docker

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

10 種可用工具

• preco_diario — 農產品現貨價格（CEPEA/ESALQ）
• futuros_b3 — B3 交易所農產品期貨每日結算
• estimativa_safra — 按州劃分的當前作物季節預估（CONAB/IBGE）
• producao_anual — 按州劃分的歷史產量（IBGE PAM）
• balanco — 供需平衡（CONAB）
• progresso_safra — 每週種植和收穫進度（CONAB）
• clima — 按州劃分的氣候數據（NASA POWER）
• desmatamento — 按生物群落劃分的森林砍伐率和警報（INPE）
• listar_produtos — 列出每個工具的有效產品
• health_check — 檢查數據源的狀態

鏈接

• agrobr library — 農業數據庫
• MCP Protocol — 模型上下文協議

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