건강주치의 (MyHealth Companion) MCP

어려운 검사·약·음식을 내 정보에 맞춰 풀어주는 AI 건강 동반자. 카카오 PlayMCP 공모전(AGENTIC PLAYER 10) 출품용.

진단·처방이 아닙니다. 공식·큐레이션 데이터에 기반한 참고 정보만 제공하며, 모든 응답에 디스클레이머가 포함됩니다. 개인화는 호스트 LLM이 대화 맥락으로 수행(stateless).

Tools (3, stateless)

tool	기능
interpret_lab	검사 항목+수치 → 표준 참고치 비교·의미 (검진 결과지 해석)
food_check	음식 + 내 프로필(약·상태·검사수치) → 알려진 상호작용/주의 (근거 기반)
lookup_medication	약명 → 식약처 e약은요 공식 정보 (효능·복용법·주의·상호작용·부작용)

구조

server.py                 FastMCP (tool 3종, annotations 5종, 디스클레이머)
medical_helper/
  data/lab_reference.py   표준 검사 참고치 + 해석 (큐레이션)
  data/food_caution.py    음식-약/상태 주의 룰 (큐레이션, 환각 방지)
  data/mfds.py            식약처 e약은요 OpenAPI 클라이언트 (MFDS_SERVICE_KEY)
  guardrail.py            디스클레이머 + 진단 단정어 자가점검
tests/smoke.py            tool 등록·시나리오·가드레일 검증

개발

/opt/homebrew/bin/python3.11 -m venv .venv
.venv/bin/pip install mcp requests
.venv/bin/python tests/smoke.py
.venv/bin/python server.py                  # stdio
npx @modelcontextprotocol/inspector .venv/bin/python server.py   # Inspector

Claude Desktop 연결 (로컬 테스트)

~/Library/Application Support/Claude/claude_desktop_config.json에 등록됨:

"mcpServers": {
  "myhealth-companion": {
    "command": "/Users/taejin/medical-helper-mcp/.venv/bin/python",
    "args": ["/Users/taejin/medical-helper-mcp/server.py"]
  }
}

→ Claude Desktop 완전 종료 후 재시작 → 입력창 도구 아이콘에 myhealth-companion 표시 → 대화로 tool 3종 호출.

⚠️ 미해결 (배포 전)

• MFDS_SERVICE_KEY 발급(공공데이터포털 15075057) → 약 tool 라이브.
• 멀티모달: 카톡 첨부 이미지→tool 전달 지원 확인 시 검사지/처방전 OCR 보강.
• stdio → Streamable HTTP(Remote·stateless) → 카카오클라우드 배포 → PlayMCP 등록.
• 데이터 커버리지: 검사 28항목·음식 50+종·룰 16개(추가 확대 여지).

공모전 제약 준수

• [x] tool 3개 / 입력 텍스트·JSON / annotations 5종 / 'kakao' 미포함 / 영문+서비스명 병기
• [x] 의료법 가드레일(진단·처방 금지, 디스클레이머, 자가점검) / stateless
• [ ] Streamable HTTP·Remote / 카카오클라우드 배포 / e약은요 키