농업: 농산물 가격 모니터링 및 조기 경보

이 MCP 서비스는 농산물 가격 모니터링 및 조기 경보를 중심으로, 농산물 가격 시세, 농업 가격 지수, 일/주/월 시장 보고서 조회 기능을 제공하여 가격 변동 식별과 시장 추세 판단에 데이터 기반을 제공합니다.

소속 분야: 시장 무역

주요 기능

• 농산물 가격 시세 모니터링

• 산지와 시장 가격 비교

• 농업 가격 지수 추적

• 농업 시장 분석 및 조기 경보 판단

Related MCP server: Ecommerce Price Monitor MCP

서비스 설계 설명

• 서비스는 가격 모니터링 및 조기 경보 판단에 필요한 조회 데이터를 제공하며, 백그라운드에서 지속적으로 실행되지 않고 알림을 능동적으로 발송하지 않습니다.

• 서비스는 3개의 읽기 전용 Tool을 제공하며, 단일 Tool 호출은 하나의 Product ID만 접근합니다.

• 페이지네이션 결과는 total과 resultList로 통일됩니다.

• 성공 응답은 Gateway 비즈니스 data와 내부 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"
    }
  }
}

사용 가능한 Tool과 Product ID

권장 분석 흐름

1. agriculture_product_search를 사용하여 대상 농산물의 현재 평균가, 고가/저가, 등락률, 산지와 시장 차이를 조회합니다.

2. agriculture_price_index를 사용하여 동일 날짜의 전체 가격 지수를 조회합니다.

3. agriculture_market_report를 사용하여 일간, 주간 또는 월간 보고서를 확보하고 변동 원인을 해석하여 조기 경보 판단을 수립합니다.

본 서비스는 모니터링 및 조기 경보에 필요한 데이터를 제공하며, 백그라운드에서 지속적으로 실행되지 않고 알림을 능동적으로 발송하지 않습니다.

Tool 상세 설명

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: 가격 지수 조회

2026년 8월 11일의 농업 가격 지수와 전일 대비 변동을 조회합니다.

{
  "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를 호출하여 수행합니다.