타이난 정신건강 리소스 MCP

타이난시 보건국 수십 개 하위 메뉴에 흩어져 있는 정신건강 리소스를 한 마디면 조회할 수 있는 것으로 바꿉니다.

你說：我們機構在哪幾份官方名單上？
它做：查四個來源 → 寬欣心理治療所 ＋ 芯寬欣，兩個據點都在，
      而且你們在「免費諮商合作名單」裡，每週一至五 8:00-21:00

이 도구가 존재하는 이유

이 데이터는 수동으로도 찾을 수 있습니다. 문제는 그 URL이 이렇게 생겼다는 점입니다:

https://health.tainan.gov.tw/page.asp?mainid=0A3943E7-033E-4686-8514-7BD39368D32D

의미가 없고 GUID 문자열일 뿐입니다. 추측할 수 없고, 홈페이지에서 한 단계씩 클릭해서 들어가야만 합니다.

그래서 이 도구의 가치는 "데이터 확보"가 아니라 여러 출처의 교차 비교 자동화에 있습니다:

• 세 개의 공식 명단이 서로 누구를 빠뜨렸는가?

• 한 행정구가 실제로 어느 정신건강센터 관할인가?

• 무료 상담 시간대가 요일별로 어떻게 분포되어 있고, 어느 날은 아예 없는가?

이런 작업은 수동으로 하면 반나절이 걸리고, 다음 달 데이터가 바뀌면 처음부터 다시 해야 합니다.

Related MCP server: Taiwan Government Open Data MCP Server

5분이면 설치 완료

git clone https://github.com/scatjay/kxmind-tainan-mental-mcp.git
cd kxmind-tainan-mental-mcp
pip install -r requirements.txt

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "tainan-mental": {
      "command": "python",
      "args": ["C:/你的路徑/kxmind-tainan-mental-mcp/server.py"]
    }
  }
}

Claude를 재시작한 다음 "ping 실행"이라고 말하세요. 데이터 건수가 보이면 연결된 것입니다.

가입할 계정도, 신청할 키도 없습니다. repo에 데이터 스냅샷이 이미 포함되어 있습니다.

아홉 개의 도구

읽기 계층

분석 계층 — 이 계층이 핵심입니다

현장에서 실행 가능한 세 가지 실례

1. find_myself("寬欣") — 자기 자신 조회

「寬欣」出現在 6 個地方：
  【地圖／心理治療、諮商所】寬欣心理治療所    北區育德一街227號1、2樓  (06)2510966
  【地圖／心理治療、諮商所】芯寬欣心理治療所  北區北安路一段273號      (06)2510560
  【免費諮商合作名單】      寬欣心理治療所    週一 每週一至五 8:00-21:00
  【衛生局名冊】…

2. diff_clinic_sources() — 세 개의 공식 명단이 서로 누구를 빠뜨렸는지

衛生局名冊 32 家 ／ 資源地圖 26 家 ／ 兩邊都有 24 家

只在名冊、地圖沒有（8 家）
   誼仁、欣空間、欣橋、星語、愛相會、好心情、山實、沐盼

只在地圖、名冊沒有（2 家）
   心物語、李慧芳

단방향 누락이 아니라, 두 공식 문서가 서로의 존재를 모르는 상황입니다.

3. which_center("永康區") — 아무도 맞히지 못하는 문제

永康區 → 善化區社區心理衛生中心   (06)581-0105

융캉 자신이 아닙니다. 6개 센터의 서비스 지역을 합치면 정확히 37개 구, 중복도 누락도 없습니다. 따라서 어떤 행정구든 답을 찾을 수 있고, 데모가 막히지 않습니다.

🔴 현장 규율: 기본적으로 스냅샷을 읽고, 전원이 동시에 정부 사이트를 때리지 않기

data/에는 2026-08-27에 수집한 스냅샷이 수집 시각 타임스탬프와 함께 들어 있습니다. 모든 도구는 기본적으로 이를 읽습니다.

이유: 워크숍에 십수 명이 같은 IP로 같은 시간에 접속합니다. 모두가 동시에 정부 사이트를 때리면 속도 제한이 걸릴 위험이 있고, 행사장 WiFi 품질도 보통 불확실합니다.

데이터를 갱신하려면:

python fetch_snapshot.py

또는 refresh_snapshot() 호출 — 단, 현장에서는 강사가 한 번만 시연하고, 나머지는 스냅샷을 읽습니다.

데이터 출처

전부 공개 데이터이며, 어떤 권한도 신청할 필요가 없습니다. 모든 항목은 2026-08-27에 독립적인 대조 검증을 거쳤습니다 (100건 통과, 22건은 URL 만료 또는 내용 불일치로 제외).

데이터 품질: 코드에 남겨둔 함정들

이 도구를 만들면서 겪었고, 모두 주석으로 남겨두었습니다:

• 무료 상담 58건의 <name>이 전부 같은 문자열 "預約免費心理諮商"입니다. 실제 위치는 ExtendedData의 "諮商地點" 필드에 있습니다. name만 읽으면 58개의 동일한 지점이 나옵니다.

• CSV에 이중 BOM (EF BB BF EF BB BF)이 있습니다. utf-8-sig는 한 겹만 벗겨내서 첫 번째 컬럼명에 보이지 않는 문자가 남습니다.

• 정신건강센터 서비스 지역: 첫 버전에서는 "센터 이름 주변 900자 안에서 regex로 모든 XX區를 추출"했는데, 그 결과 산화 센터가 26개 구가 되고 "서비스구역" "비전단지" "커뮤니티" 같은 가짜가 섞였습니다. 조회가 우연히 맞을 수는 있지만 — 우연히 맞는 도구는 가르칠 수 없습니다. 服務區域： 줄만 읽도록 바꿔서 이제 6곳을 합치면 정확히 37개 구입니다.

• 기관명은 정규화해야 비교할 수 있습니다: 台南／臺南, "社團法人" 접두사 유무.

⚠️ 사용 시 유의사항

• 여기 데이터는 공개 정보의 스냅샷이지 실시간 시스템이 아닙니다. 의뢰 전에 전화로 확인하는 것을 권장합니다.

• "타이난에 정신의료기관이 몇 개인가"에는 단일 답이 없습니다 — count_by_layer()가 그 이유를 알려줍니다. 그리고 강제 입원이 가능한 "지정 기관"은 41개가 아니라 7개뿐입니다.

• 이 도구는 어떤 사례 데이터도 처리하지 않습니다. 조회 대상은 기관이지 사람이 아닙니다.

라이선스

MIT. 데이터 저작권은 타이난시 보건국과 타이난시 데이터 개방 플랫폼에 있습니다.