Landwirtschaft: Preisüberwachung und Frühwarnung für Agrarprodukte

Dieser MCP-Dienst bietet im Bereich der Preisüberwachung und Frühwarnung für Agrarprodukte Abfragefunktionen für Agrarmarktpreise, landwirtschaftliche Preisindizes sowie Tages-, Wochen- und Monatsmarktberichte und liefert damit die Datengrundlage für die Erkennung von Preisschwankungen und die Bewertung von Markttrends.

Zugehöriger Bereich: Markthandel

Hauptfunktionen

• Preisüberwachung für Agrarprodukte

• Vergleich von Erzeuger- und Marktpreisen

• Verfolgung von Agrarpreisindizes

• Marktanalyse und Frühwarnung in der Landwirtschaft

Related MCP server: Ecommerce Price Monitor MCP

Hinweise zum Servicedesign

• Der Dienst stellt die für die Preisüberwachung und Frühwarnung erforderlichen Abfragedaten bereit; er läuft nicht dauerhaft im Hintergrund und sendet keine Warnmeldungen aktiv.

• Der Dienst stellt 3 schreibgeschützte Tools bereit; ein einzelner Tool-Aufruf greift nur auf eine Product ID zu.

• Seitenergebnisse werden einheitlich zu total und resultList zusammengefasst.

• Erfolgreiche Antworten sind automatisch mit den beiden Formen kompatibel: den Gateway-Geschäftsdaten (data) und dem internen stat/data.

• Das Anforderungszeitlimit kann über HANDAAS_REQUEST_TIMEOUT konfiguriert werden; der Standardwert beträgt 30 Sekunden.

Umgebungsanforderungen

• Python 3.10+

• Abhängigkeiten: mcp, python-dotenv, requests

Lokaler Schnellstart

cd agriculture-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

Die Standardadresse des Dienstes lautet: http://127.0.0.1:8000/mcp. Unterstützt werden stdio, sse und streamable-http.

Umgebungsvariablen

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

Echte Zugangsdaten dürfen nur in einer lokalen .env-Datei oder im Deployment-Schlüssel gespeichert werden.

Konfiguration in Cursor / Cherry Studio

{
  "mcpServers": {
    "agriculture-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Verfügbare Tools und Product-IDs

Empfohlener Analyseablauf

1. Verwenden Sie agriculture_product_search, um den aktuellen Durchschnittspreis, Höchst- und Tiefstpreis, die Preisveränderung sowie die Unterschiede zwischen Erzeuger- und Marktpreisen für das gewünschte Agrarprodukt abzufragen.

2. Verwenden Sie agriculture_price_index, um den Gesamtpreisindex für dasselbe Datum abzufragen.

3. Verwenden Sie agriculture_market_report, um Tages-, Wochen- oder Monatsberichte zu erhalten, die Ursachen von Schwankungen zu erläutern und eine Frühwarnung zu erstellen.

Dieser Dienst stellt die für Überwachung und Frühwarnung erforderlichen Daten bereit, läuft jedoch nicht dauerhaft im Hintergrund und sendet auch keine aktiven Warnmeldungen.

Detaillierte Beschreibung der Tools

1. agriculture_product_search

Verwendung: Abfrage der aktuellen Preise, der prozentualen Veränderung, der Märkte mit Höchst- und Tiefstpreisen sowie der Herkunftsunterschiede für ein bestimmtes Agrarprodukt oder paginiertes Durchsuchen aller Agrarprodukte.

Wichtige Parameter: productName unterstützt eine unscharfe Suche; pageIndex beginnt bei 1; pageSize beträgt maximal 50.

Rückgabewerte: Es werden Kategorie, Produktname, Kursdatum, Durchschnittspreis, Höchst- und Tiefstpreis sowie Markt- und Herkunftsinformationen zurückgegeben. Alle Preise müssen anhand der zurückgegebenen Einheit unit interpretiert werden.

2. agriculture_price_index

Verwendung: Abfrage des Gesamtpreisindex für den Agrargroßhandel, den Gemüsekorb sowie für Getreide und Öl an einem bestimmten Tag.

Wichtige Parameter: publishTime ist erforderlich und muss das Format YYYY-MM-DD haben.

Rückgabewerte: Zurückgegeben werden Indexname, aktueller Wert, Wert des Vortags und Veränderung gegenüber dem Vortag; fehlende Daten für ein Datum werden nicht interpoliert, sondern es wird direkt ein leeres Ergebnis zurückgegeben.

3. agriculture_market_report

Verwendung: Verwenden Sie dieses Tool, wenn Marktberichte benötigt werden, um aktuelle Preisveränderungen oder Angebots- und Nachfragesituationen zu erläutern oder eine Grundlage für Risikofrühwarnungen zu schaffen.

Wichtige Parameter: reportType unterstützt nur day, week und month; size liegt im Bereich von 1 bis 9.

Rückgabewerte: Zurückgegeben werden Berichtsdatum, Titel, Text, Typ und Quelle; resultList enthält maximal size Einträge.

Verwendungsbeispiele

Beispiel 1: Agrarproduktkurse abfragen

Abfragen des aktuellen Durchschnittspreises, Höchstpreises, Mindestpreises und der Preisveränderung von Chinakohl.

{
  "tool": "agriculture_product_search",
  "arguments": {
    "productName": "白菜",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Beispiel 2: Preisindex abfragen

Abfragen des Agrarpreisindex sowie der Veränderung gegenüber dem Vortag für den 11. August 2026.

{
  "tool": "agriculture_price_index",
  "arguments": {
    "publishTime": "2026-08-11"
  }
}

Beispiel 3: Wöchentliche Frühwarnung erstellen

Abrufen der letzten 3 Landwirtschafts-Wochenberichte und anhand der Chinakohlpreise beurteilen, ob deutliche Schwankungen vorliegen.

{
  "tool": "agriculture_market_report",
  "arguments": {
    "reportType": "week",
    "size": 3
  }
}

Hinweise zur Verwendung

1. Verwenden Sie die von der Schnittstelle zurückgegebene Einheit unit; rechnen Sie nicht selbst um.

2. Fehlende Indexdaten werden nicht interpoliert.

3. Die Anzahl der Berichte size liegt zwischen 1 und 9.

4. Frühwarnungen sollten Kurse, Indizes und Berichte gemeinsam berücksichtigen und nicht nur auf einem einzelnen Preiswert basieren.

Test und Validierung

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

Die Unit-Tests verwenden Mock-Antworten; die echte Validierung erfolgt über einen Aufruf des HandaaS Integrator Gateway mithilfe der lokalen .env.