Agricultura: Monitoreo y alerta de precios de productos agrícolas

Este servicio MCP se centra en el monitoreo y alerta de precios de productos agrícolas, ofreciendo capacidades de consulta de cotizaciones de productos agrícolas, índices de precios agrícolas y reportes de mercado diarios, semanales y mensuales, proporcionando una base de datos para la identificación de fluctuaciones de precios y el análisis de tendencias del mercado.

Sector: Comercio de mercado

Funciones principales

• Monitoreo de cotizaciones de productos agrícolas

• Comparación de precios entre origen y mercado

• Seguimiento de índices de precios agrícolas

• Análisis de mercado agrícola y evaluación de alertas

Related MCP server: Ecommerce Price Monitor MCP

Descripción del diseño del servicio

• El servicio proporciona los datos de consulta necesarios para el monitoreo de precios y la evaluación de alertas; no se ejecuta de forma continua en segundo plano ni envía notificaciones de alerta de forma proactiva.

• El servicio ofrece 3 herramientas de solo lectura; cada llamada a una herramienta accede únicamente a un ID de producto.

• Los resultados paginados se unifican en total y resultList.

• Las respuestas exitosas son automáticamente compatibles con los datos de negocio de Gateway y con las formas internas stat/data.

• El tiempo de espera de las solicitudes se puede configurar mediante HANDAAS_REQUEST_TIMEOUT; el valor predeterminado es de 30 segundos.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

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

Dirección predeterminada del servicio: http://127.0.0.1:8000/mcp. Compatible con stdio, sse y streamable-http.

Variables de entorno

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

Las credenciales reales solo deben guardarse en el .env local o en las claves de implementación.

Configuración de Cursor / Cherry Studio

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

Herramientas disponibles e ID de producto

Flujo de análisis recomendado

1. Utilice agriculture_product_search para consultar el precio promedio actual, los precios altos/bajos, la variación y las diferencias entre origen y mercado del producto agrícola objetivo.

2. Utilice agriculture_price_index para consultar el índice de precios general de la misma fecha.

3. Utilice agriculture_market_report para obtener reportes diarios, semanales o mensuales, explicar las causas de las fluctuaciones y formular una evaluación de alerta.

Este servicio proporciona los datos necesarios para el monitoreo y la alerta; no se ejecuta de forma continua en segundo plano ni envía alertas de forma proactiva.

Descripción detallada de las herramientas

1. agriculture_product_search

Cuándo usarla: para consultar el precio más reciente de un producto agrícola, la variación porcentual, los mercados de precios altos/bajos y las diferencias de origen, o para navegar por todos los productos agrícolas de forma paginada.

Parámetros clave: productName admite búsqueda difusa; pageIndex comienza en 1; pageSize tiene un máximo de 50.

Descripción de la respuesta: devuelve la categoría, el nombre del producto, la fecha de cotización, el precio promedio, los precios altos/bajos, el mercado y la información de origen. Todos los precios deben interpretarse junto con el unit devuelto.

2. agriculture_price_index

Cuándo usarla: para consultar los índices de precios generales de un día determinado, como los de productos agrícolas al por mayor, la canasta básica o cereales y aceites.

Parámetros clave: publishTime es obligatorio, con formato YYYY-MM-DD.

Descripción de la respuesta: devuelve el nombre del índice, el valor actual, el valor del día anterior y la variación intermensual; las fechas faltantes no se interpolar, se devuelve directamente un resultado vacío.

3. agriculture_market_report

Cuándo usarla: cuando se necesite un reporte de mercado para explicar los cambios recientes de precios, la situación de oferta y demanda, o para fundamentar una evaluación de riesgo de alerta.

Parámetros clave: reportType solo admite day, week y month; size tiene un rango de 1 a 9.

Descripción de la respuesta: devuelve la fecha del reporte, el título, el cuerpo, el tipo y la fuente; resultList contiene como máximo size registros.

Ejemplos de uso

Ejemplo uno: consultar cotizaciones de productos agrícolas

Consultar el precio promedio más reciente, el precio máximo, el precio mínimo y la variación de la col china.

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

Ejemplo dos: consultar el índice de precios

Consultar el índice de precios agrícolas del 11 de agosto de 2026 y su variación intermensual.

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

Ejemplo tres: formular una evaluación de alerta semanal

Obtener los 3 reportes agrícolas semanales más recientes y, junto con el precio de la col china, determinar si existe una fluctuación significativa.

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

Notas de uso

1. La unidad de precio utiliza el unit devuelto por la interfaz; no realice conversiones por su cuenta.

2. Las fechas faltantes en los índices no se interpolar.

3. El rango de size para la cantidad de reportes es de 1 a 9.

4. Las conclusiones de alerta deben integrar cotizaciones, índices y reportes; no deben basarse únicamente en un solo punto de precio.

Pruebas y verificación

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

Las pruebas unitarias utilizan respuestas simuladas (Mock); la verificación real se realiza mediante la llamada al Gateway Integrador de HandaaS a través del .env local.