Here Now ER

"새벽 2시에 아이가 열이 나요. 지금 갈 수 있는 병원이랑, 집에 있는 이 해열제 먹여도 되는지 알려주세요."

한밤중·주말·공휴일의 의료 공백을 카카오톡 채팅 한 번으로 해결하는 MCP 서버. 카카오 「에이전틱 플레이어 10」 공모전 출품작입니다.

• 기획 문서: PRD.md
• PlayMCP 등록 입력값: PLAYMCP_REGISTRATION.md

제공 도구 (5종)

Tool	설명	데이터 출처
find_emergency_rooms	실시간 응급실 가용 병상 조회	국립중앙의료원 E-Gen
find_open_hospitals	야간·휴일 진료 병원 검색 (지금 진료 중 필터)	국립중앙의료원 E-Gen
find_open_pharmacies	지금 영업 중인 약국 검색 (늦게 닫는 순)	국립중앙의료원 E-Gen
get_drug_info	의약품 효능·용법·주의사항·상호작용·부작용	식약처 e약은요
identify_pill	각인·색상·모양으로 알약 식별	식약처 낱알식별정보

시작하기

1. 공공데이터포털 인증키 발급

data.go.kr에서 회원가입 후 아래 5개 API를 활용신청하세요 (자동승인, 수분~수시간).

1. 국립중앙의료원_전국 응급의료기관 정보 조회 서비스
2. 국립중앙의료원_전국 병·의원 찾기 서비스
3. 국립중앙의료원_전국 약국 정보 조회 서비스
4. 식품의약품안전처_의약품개요정보(e약은요) 조회 서비스
5. 식품의약품안전처_의약품 낱알식별 정보 조회 서비스

하나의 계정이면 동일한 인증키로 5개 모두 사용 가능합니다. .env에는 Decoding 키를 넣으세요.

2. 실행

cp .env.example .env   # DATA_GO_KR_SERVICE_KEY 설정
npm install
npm run build
npm start              # http://localhost:3000/mcp

개발 모드: npm run dev

3. 동작 확인

curl http://localhost:3000/healthz

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_drug_info","arguments":{"drugName":"타이레놀"}}}'

아키텍처

• Node.js 20+ / TypeScript / Express
• MCP Streamable HTTP (stateless) — 요청마다 독립 인스턴스로 세션 충돌 없이 수평 확장
• 인메모리 TTL 캐시 — 응급실 실시간 1분, 병원/약국 10분, 의약품 24시간 (일 1,000건 호출 한도 절감)
• 모든 "지금" 판정은 Asia/Seoul(KST) 기준, 자정 넘김 영업시간(예: 09:00~익일 02:00) 처리

배포 (카카오 클라우드)

1. 카카오 클라우드 인스턴스/컨테이너에 배포 (PORT, DATA_GO_KR_SERVICE_KEY 환경변수 설정)
2. HTTPS 리버스 프록시 뒤에 POST /mcp 노출
3. PlayMCP에서 서버 등록 → PLAYMCP_REGISTRATION.md의 값 입력
4. 심사 전 전체 공개로 설정

면책

본 서비스는 의료 행위가 아닌 공공데이터 안내 서비스입니다. 병상·영업시간 정보는 기관 입력 시점 기준으로 실제와 다를 수 있으므로 방문 전 전화 확인이 필요하며, 위급 상황에서는 119에 우선 신고하세요.