# 임신·출산·육아 원스톱 AI 동반자 MCP

> Kakao PlayMCP × Agentic Player 10 공모전 출품작

임신부·출산·육아 관련 정보를 Claude AI와 대화로 한 번에 해결하는 MCP 서버입니다.
질병관리청, 건강보험심사평가원, 복지로 등 **공공 API 기반** — 무료·안정적입니다.

## 사용 시나리오

```
"저 임신 28주인데 이번 달 검진 뭐 있어요?"
→ 28주차 태아 발달 + 이번 달 검진 항목 즉시 반환

"아기가 2025년 12월 1일 생인데 예방접종 현황 알려줘"
→ BCG·DTaP·IPV 등 전체 접종 완료/예정/지연 현황

"마포구에서 DTaP 맞을 수 있는 병원 찾아줘"
→ 예방접종 가능 의료기관 목록 반환

"경기도 수원시 산모 지원혜택 알려줘"
→ 국민행복카드·첫만남이용권·부모급여·아동수당 + 경기도 추가 혜택

"아기 생후 6개월인데 이유식 어떻게 시작해?"
→ 이유식 시작 가이드, 주의 식품, 발달 이정표

"출산 후 2주인데 회복은 어떻게 해야 해요?"
→ 오로 관찰, 유방 관리, 산후 우울증 체크, 신생아 케어 요점
```

## Tools (7개)

| Tool | 기능 |
|------|------|
| `pregnancy_week_info(week)` | 임신 주차별 태아 발달·검진·주의사항 |
| `prenatal_checkup_schedule(due_date)` | 출산 예정일 기반 전체 산전 검진 일정표 |
| `vaccination_schedule(birth_date)` | 영유아 예방접종 완료/예정/지연 현황 |
| `vaccination_center(location, vaccine)` | 예방접종 가능 의료기관 검색 |
| `maternity_benefits(region)` | 지역별 산모·출산 지원혜택 조회 |
| `baby_nutrition_guide(age_months)` | 개월 수별 이유식·영양 가이드 |
| `postpartum_info(weeks_after)` | 산후 주차별 회복 가이드·신생아 케어 |

## 데이터 소스 (전량 공공 API)

| 기관 | 데이터 |
|------|--------|
| 질병관리청 NIP | 국가예방접종 표준 일정 (2024년) |
| 건강보험심사평가원 | 병원·의원 정보 |
| 복지로 | 산모·신생아 지원서비스 |
| 정적 데이터 | 임신 주차별 정보, 지자체 지원금 (정기 갱신) |

## 배포 URL

**SSE (원격 연결):** `https://pregnancy-baby-mcp.fly.dev/sse`

## 설치

### Claude Desktop — 원격 SSE 연결 (권장)

```json
{
  "mcpServers": {
    "pregnancy-baby-mcp": {
      "url": "https://pregnancy-baby-mcp.fly.dev/sse"
    }
  }
}
```

### Claude Desktop — 로컬 실행

```json
{
  "mcpServers": {
    "pregnancy-baby-mcp": {
      "command": "python",
      "args": ["C:/path/to/pregnancy-baby-mcp/server.py"],
      "env": {
        "DATA_GO_API_KEY": "your_key",
        "HIRA_API_KEY": "your_key"
      }
    }
  }
}
```

### Docker (SSE 모드)

```bash
docker build -t pregnancy-baby-mcp .
docker run -p 8000:8000 \
  -e MCP_TRANSPORT=sse \
  -e DATA_GO_API_KEY=your_key \
  pregnancy-baby-mcp
```

### 로컬 실행

```bash
pip install -r requirements.txt
cp .env.example .env  # API 키 입력
python server.py
```

## 테스트

```bash
pip install pytest
pytest tests/ -v
```

## API 키 발급 (무료)

1. [data.go.kr](https://www.data.go.kr) 회원가입
2. 아래 API 신청 (즉시 발급):
   - 건강보험심사평가원 병원정보서비스
   - 보건복지부 복지서비스 API
3. `.env`에 키 입력

## 의료 면책 조항

본 서비스의 모든 정보는 **참고용**입니다. 의료적 진단·처방·결정은 반드시 담당 의사와 상담하세요.
예방접종 일정, 임신 정보는 질병관리청·산부인과 공식 가이드라인에 기반합니다.

## License

MIT