식자재 회수점검 (foodRecall)

급식·유통 현장에서 취급 중인 식자재가 식약처 회수·판매중지 대상인지, 로트 단위로 즉시 검수하는 MCP 서버.

• 라이브 Endpoint: https://foodrecallcheck.playmcp-endpoint.kakaocloud.io/mcp

• 전송: Streamable HTTP, Stateless (POST /mcp)

• 실데이터: 식품안전나라 회수·판매중지(I0490) 전량 메모리 적재 (기동 시 확인 355건)

• 도구 7개, 생성형 0개 (환각 없는 사실 대조 전용)

문제

식약처는 매일 식품 회수·판매중지를 공고한다. 그런데 회수는 보통 제품명 전체가 아니라 특정 제조일자·유통기한 로트에만 적용된다. 급식소·어린이집·편의점·유통사의 검수 담당자는 입고 때마다 "이 물건이 회수 대상인지"를 확인해야 하지만, 공개 사이트는 목록만 보여줄 뿐 "지금 내 물건이 해당되는가"를 판정해 주지 않는다. LLM은 최신 회수 목록을 모른다.

Related MCP server: K-MFDS FoodDB MCP Server

대상 사용자

학교·기관 급식소, 어린이집, 편의점, 식자재 유통사의 입고 검수 담당자.

왜 사이트로는 안 되고 이 MCP가 필요한가

식품안전나라 웹사이트로는 못 하고, 이 서버만 하는 세 가지:

1. 바코드 역조회 — 바코드 숫자로 회수 건을 거꾸로 찾는다. 웹 검색·사이트로는 불가능하다.

2. 재고 30건 일괄 검수 — 납품 목록·식단표를 한 번에 대조한다. 사이트라면 30번 검색해야 한다.

3. 제조업체별 회수 이력 집계 — 특정 업체의 누적 회수 건수를 낸다. 원본 API가 제공하지 않는 값으로, 발주 전 공급사 스크리닝에 쓴다.

판정 모델 (오탐 방지가 핵심)

모든 대조는 해당 / 추가 정보 필요 / 미해당 세 가지로만 답한다. 퍼지 매칭을 하지 않는다.

• 제품명이 회수 목록에 있으면 먼저 경고하고, 회수 대상 로트인지 확정하기 위해 제조일자·업체를 요청한다.

• 같은 제품명이라도 제조업체가 다르면 "해당"으로 단정하지 않는다(동명이인 제품 오탐 차단).

• 회수 레코드에 로트 제한이 없으면(규제당국이 제품 전체 회수) 업체·바코드 일치 시 "해당"으로 판정한다.

검수는 잘못 통과시키는 것도, 멀쩡한 물건을 잘못 폐기시키는 것도 사고다. 그래서 근거 필드를 항상 함께 반환해 사람이 검증할 수 있게 했다.

도구 7개

아키텍처 / 100ms 대응

PlayMCP 요구: 툴 응답 평균 100ms, p99 3,000ms. 기동 시 회수 데이터를 전량 메모리에 적재하고 주기 갱신한다. 도구 호출 경로에는 외부 API 호출이 전혀 없다. 모든 조회는 메모리 인덱스(제품명·바코드·업체)에서 처리된다.

데이터 출처

• 식품안전나라 회수·판매중지 (서비스 I0490) — 국내·수입 회수를 모두 포함. 현재 이 소스로 운영.

• (확장 예정) 공공데이터포털 15074318 국내 회수, 15095378 수입식품 회수 — 승인된 엔드포인트 URL 확보 시 폴백 소스로 추가.

로컬 실행

cp .env.example .env      # FOODSAFETYKOREA_API_KEY 입력
npm i
npm run test:match        # 판정 로직 검증 (네트워크 불필요)
npm run test:schema       # 실스키마·날짜 파싱 검증
npm run build && npm start
curl localhost:8080/health   # {"ready":true,"records":355,...}

상태

• 타입 검사 0 에러, 판정 테스트 11/11, 스키마 테스트 14/14 통과

• 카카오 클라우드 배포 완료(Active), 실서버에서 도구 7개·355건 응답 확인