Сельское хозяйство: мониторинг и предупреждение цен на сельскохозяйственную продукцию

Этот MCP-сервис, посвящённый мониторингу и предупреждению цен на сельскохозяйственную продукцию, предоставляет возможности запроса цен на сельскохозяйственную продукцию, сельскохозяйственных ценовых индексов и ежедневных, еженедельных и ежемесячных рыночных отчётов, обеспечивая данные для выявления ценовых колебаний и прогнозирования рыночных тенденций.

Раздел: Рыночная торговля

Основные функции

• Мониторинг цен на сельскохозяйственную продукцию

• Сравнение цен производителей и рыночных цен

• Отслеживание сельскохозяйственных ценовых индексов

• Анализ сельскохозяйственного рынка и прогнозирование предупреждений

Related MCP server: Ecommerce Price Monitor MCP

Описание дизайна сервиса

• Сервис предоставляет данные запросов, необходимые для мониторинга цен и прогнозирования предупреждений, не работает в фоновом режиме постоянно и не отправляет уведомления об оповещениях активно.

• Сервис предоставляет 3 инструмента только для чтения; один вызов инструмента обращается только к одному Product ID.

• Результаты постраничной навигации единообразно сводятся к total и resultList.

• Успешные ответы автоматически совместимы с формами данных Gateway и внутренними stat/data.

• Тайм-аут запроса можно настроить через HANDAAS_REQUEST_TIMEOUT, по умолчанию 30 секунд.

Требования к окружению

• Python 3.10+

• Зависимости: mcp, python-dotenv, requests

Быстрый локальный запуск

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

Адрес сервиса по умолчанию: http://127.0.0.1:8000/mcp. Поддерживаются stdio, sse и streamable-http.

Переменные окружения

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

Реальные учётные данные могут храниться только в локальном .env или в ключах развёртывания.

Конфигурация Cursor / Cherry Studio

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

Доступные инструменты и Product ID

Рекомендуемый процесс анализа

1. Используйте agriculture_product_search для запроса текущей средней цены, высоких и низких цен, изменений и различий между рынками и местами производства целевой сельскохозяйственной продукции.

2. Используйте agriculture_price_index для запроса общего ценового индекса на ту же дату.

3. Используйте agriculture_market_report для получения ежедневных, еженедельных или ежемесячных отчётов, объяснения причин колебаний и формирования прогноза предупреждений.

Этот сервис предоставляет данные, необходимые для мониторинга и предупреждений, не работает в фоновом режиме постоянно и не отправляет оповещения активно.

Подробное описание инструментов

1. agriculture_product_search

Когда использовать: для запроса последних цен на конкретный вид сельскохозяйственной продукции, процентных изменений, рынков с высокими и низкими ценами и различий по местам производства, или для постраничного просмотра всей сельскохозяйственной продукции.

Ключевые параметры: productName поддерживает нечёткий поиск; pageIndex начинается с 1; pageSize максимум 50.

Описание возвращаемых данных: возвращаются категория, название продукта, дата котировки, средняя цена, высокие и низкие цены, информация о рынке и месте производства. Все цены должны интерпретироваться с учётом возвращаемого unit.

2. agriculture_price_index

Когда использовать: для запроса общего ценового индекса на определённый день, например, оптовых цен на сельскохозяйственную продукцию, продуктовой корзины, зерна и масла.

Ключевые параметры: publishTime обязателен, формат YYYY-MM-DD.

Описание возвращаемых данных: возвращаются название индекса, текущее значение, значение за предыдущий день и изменение по сравнению с предыдущим периодом; для отсутствующих дат интерполяция не выполняется, возвращается пустой результат.

3. agriculture_market_report

Когда использовать: когда необходимо использовать рыночные отчёты для объяснения недавних изменений цен, ситуации со спросом и предложением или формирования основы для предупреждения о рисках.

Ключевые параметры: reportType поддерживает только day, week, month; size в диапазоне от 1 до 9.

Описание возвращаемых данных: возвращаются дата отчёта, заголовок, текст, тип и источник; resultList содержит не более size записей.

Примеры использования

Пример 1: Запрос цен на сельскохозяйственную продукцию

Запрос последней средней цены, максимальной цены, минимальной цены и изменений для капусты.

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

Пример 2: Запрос ценового индекса

Запрос сельскохозяйственного ценового индекса и изменений по сравнению с предыдущим периодом на 11 августа 2026 года.

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

Пример 3: Формирование еженедельного прогноза предупреждений

Получить последние 3 еженедельных отчёта по сельскому хозяйству и, используя цены на капусту, определить, есть ли значительные колебания.

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

Примечания по использованию

1. Единицы цен должны использовать unit, возвращаемый интерфейсом, без самостоятельного пересчёта.

2. Для отсутствующих дат индекса интерполяция не выполняется.

3. Количество отчётов size в диапазоне от 1 до 9.

4. Выводы о предупреждениях должны основываться на совокупности котировок, индексов и отчётов, а не только на отдельных ценовых точках.

Тестирование и проверка

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

Модульные тесты используют Mock-ответы; реальная проверка выполняется через локальный .env с вызовом HandaaS Integrator Gateway.