@minjunkwon/korea-welfare-mcp-server/USAGE_GUIDE.md

MCP server for Korean Central Government Welfare Services - provides intelligent search and information retrieval for Korean social welfare programs

# 한국 복지서비스 MCP 서버 사용 가이드

## 🚀 Claude Desktop에서 사용하는 방법

### 1. 기본 사용법

#### 자연어 검색 (추천)
가장 쉽고 직관적인 방법입니다. 사용자의 요청을 그대로 전달하세요.

```
임신 출산 관련 복지서비스 찾아줘
청년 일자리 지원사업 알려줘
저소득층 주거 지원 서비스 알려줘
장애인을 위한 복지서비스는 뭐가 있어?
온라인으로 신청할 수 있는 서비스 찾아줘
```

#### 코드 정의 조회
```
복지서비스 API에서 사용하는 코드가 뭐야?
생애주기 코드를 알려줘
```

#### 상세 정보 조회
```
WLF00001138 서비스의 상세 정보를 알려줘
이 서비스 ID의 자세한 내용은? WLF00001188
```

### 2. 키워드별 검색 예시

#### 생애주기별 검색
- **영유아**: "영유아 대상 복지서비스", "신생아 지원사업"
- **아동**: "아동 복지서비스", "어린이 지원사업"
- **청소년**: "청소년 복지서비스", "중고등학생 지원"
- **청년**: "청년 지원사업", "20대 30대 복지"
- **중장년**: "중장년 복지서비스", "40대 50대 지원"
- **노년**: "노인 복지서비스", "어르신 지원사업"
- **임신출산**: "임신 출산 관련 서비스", "산모 지원사업"

#### 가구유형별 검색
- **저소득**: "저소득층 복지서비스", "기초생활수급자 지원"
- **장애인**: "장애인 복지서비스", "장애인 지원사업"
- **다자녀**: "다자녀 가정 지원", "많은 자녀 복지"
- **한부모**: "한부모 가정 지원", "미혼모 복지서비스"
- **다문화**: "다문화 가정 지원", "외국인 복지서비스"

#### 관심주제별 검색
- **일자리**: "일자리 지원사업", "취업 지원 서비스"
- **주거**: "주거 지원 서비스", "전세 월세 지원"
- **교육**: "교육비 지원", "장학금 서비스"
- **의료**: "의료비 지원", "건강 관련 서비스"
- **보육**: "어린이집 지원", "보육료 지원"

### 3. 고급 검색 기법

#### 조건 조합
```
청년 일자리 지원사업 (청년 + 일자리)
저소득층 주거 지원 (저소득 + 주거)
장애인 의료비 지원 (장애인 + 의료)
다자녀 교육비 지원 (다자녀 + 교육)
```

#### 온라인 신청 필터링
```
온라인으로 신청할 수 있는 청년 지원사업
인터넷으로 신청 가능한 복지서비스
```

#### 인기순 정렬
```
인기 있는 복지서비스 찾아줘
많이 사용하는 지원사업 추천해줘
```

### 4. 검색 결과 해석

#### 성공적인 검색 결과
```json
{
  "originalRequest": "청년 일자리 지원사업 알려줘",
  "appliedFilters": {
    "callTp": "L",
    "pageNo": 1,
    "numOfRows": 10,
    "lifeArray": "004",
    "intrsThemaArray": "050", 
    "searchWrd": "청년"
  },
  "result": {
    "wantedList": {
      "totalCount": 15,
      "servList": [...]
    }
  }
}
```

#### 적용된 필터 의미
- `lifeArray: "004"` → 청년 대상
- `intrsThemaArray: "050"` → 일자리 관련
- `searchWrd: "청년"` → 추가 키워드 검색

### 5. 문제 해결

#### 검색 결과가 없을 때
1. 더 일반적인 키워드 사용: "청년 창업 지원" → "청년 지원"
2. 다른 조건 조합 시도: "장애인 일자리" → "장애인 복지"
3. 기본 검색: "복지서비스 찾아줘"

#### 너무 많은 결과가 나올 때
1. 더 구체적인 조건 추가: "복지서비스" → "청년 일자리 복지서비스"
2. 온라인 신청 조건 추가: "온라인 신청 가능한 청년 지원"

### 6. 매개변수 직접 사용 (고급)

전문가 사용자를 위한 직접 매개변수 사용법:

```javascript
// 생애주기별 검색
search_welfare_services({ lifeCycle: "004", numOfRows: 5 })

// 복합 조건 검색  
search_welfare_services({ 
  lifeCycle: "004", 
  householdType: "050", 
  interestTheme: "050",
  numOfRows: 10 
})

// 키워드 검색
search_welfare_services({ 
  searchWord: "산모", 
  searchType: "003",
  numOfRows: 5 
})
```

## 🎯 성공적인 사용 팁

1. **자연스러운 한국어 사용**: "청년 일자리 찾아줘" (O), "lifeCycle 004" (X)
2. **구체적인 상황 설명**: "30대 직장인 주거 지원" 
3. **여러 키워드 조합**: "저소득층 아동 교육비 지원"
4. **결과가 많으면 조건 추가**: "온라인 신청 가능한 ..."
5. **결과가 적으면 조건 완화**: "청년" 대신 "지원사업"

이 가이드를 참고하여 한국의 다양한 복지서비스 정보를 효과적으로 검색하세요! 🇰🇷