@minjunkwon/localgovernment-welfare-mcp-server/README.md

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

# 지자체 복지서비스 MCP 서버

한국 지자체 복지서비스를 Claude와 연동하여 지능적으로 검색하고 조회할 수 있는 MCP 서버입니다.

## 주요 기능

### 1. 지자체 복지서비스 목록 조회 (`search_local_welfare_services`)
- 지역별 (시도, 시군구) 필터링
- 생애주기별 필터링 (영유아, 아동, 청소년, 청년, 중장년, 노년, 임신·출산)
- 가구상황별 필터링 (다문화·탈북민, 다자녀, 보훈대상자, 장애인, 저소득, 한부모·조손)
- 관심주제별 필터링 (신체건강, 정신건강, 생활지원, 주거, 일자리, 문화·여가, 안전·위기, 임신·출산, 보육, 교육, 입양·위탁, 보호·돌봄, 서민금융, 법률)

### 2. 복지서비스 상세 조회 (`get_local_welfare_detail`)
- 서비스 ID로 상세 정보 조회
- 신청 방법, 선정 기준, 지원 내용 등 포함

### 3. 코드 정의 조회 (`get_local_welfare_codes`)
- API에서 사용되는 모든 코드 체계 조회

## 설치 및 실행

```bash
npm install
npm run build
npm start
```

## Claude Desktop 연동

`claude_desktop_config.json` 파일에 다음 설정 추가:

```json
{
  "mcpServers": {
    "localgovernment-welfare": {
      "command": "node",
      "args": ["/Users/MINJUN/Desktop/localwalfare/dist/index.js"],
      "env": {}
    }
  }
}
```

## API 데이터 소스

공공데이터포털의 "지자체 복지서비스 정보" API를 활용합니다.
- 목록 조회: `/B554287/LocalGovernmentWelfareInformations/LcgvWelfarelist`
- 상세 조회: `/B554287/LocalGovernmentWelfareInformations/LcgvWelfaredetailed`