Mind Guide MCP

<p align="center"> <img src="logo.png" width="160" alt="마음길잡이 로고" /> </p>

<h1 align="center">마음길잡이 MCP</h1>

<p align="center"> 카카오 PlayMCP용 정신건강·복지 안내 MCP 서버<br/> "요즘 힘든데 근처 상담할 곳 있을까?" 한 마디로 상담기관과 복지제도를 연결합니다. </p>

---

무엇을 하는 서버인가

마음길잡이는 상담하는 봇이 아닌, 연결해주는 봇입니다.

사용자가 카카오톡에서 지역과 상황을 말로 전달하면:

• 전국 정신건강복지센터 연락처·운영시간 안내 (공공데이터 기반, 163개 기관)
• 청년 바우처·산후 정서지원 등 맞춤 복지제도 추천
• 위기 신호 감지 시 자살예방상담전화(109) 등 즉시 연락처 우선 안내

대화 내역을 읽거나 개인정보를 수집하지 않습니다. 사용자가 직접 입력한 내용만으로 동작합니다.

---

도구 (MCP Tools)

도구	설명
crisis_resources	위기 시 즉시 연락처 안내 (109, 1577-0199, 129, 1388, 119)
find_counseling_centers	지역·상황별 정신건강복지센터 추천
recommend_welfare	상황·나이·가구형태별 복지제도 추천

모든 추천 도구는 위기 신호를 먼저 감지해, 신호가 있으면 추천보다 위기 연락처를 앞에 안내합니다.

---

설계 원칙 (안전)

1. 연결하는 봇 — 감정 진단·치료 조언 금지. 실제 기관으로 연결하는 역할만 합니다.
2. 위기 우선 — 위기 신호 감지 시 추천보다 즉시 연락처를 먼저 안내합니다.
3. 위기 수단·방법은 절대 다루지 않습니다.
4. AI가 사람 상담을 대체하지 않습니다. 항상 실제 기관 연결을 권합니다.

---

데이터

• 상담기관: 공공데이터포털 전국건강증진센터표준데이터 (정신보건 필터, 2026-03 기준)
• 복지제도: 키워드 기반 매칭 (청년 바우처, 산후 지원, 노인 돌봄, 일상돌봄 등)
• 위기 연락처: 보건복지부 공식 번호 (109 통합 운영, 2024-01-01~)

---

로컬 실행

pip install -r requirements.txt
cp .env.example .env   # 필요 시 API 키 입력
python mind_guide_server.py
# → http://0.0.0.0:8000/mcp (streamable-http)

---

배포

• 플랫폼: Render (무료 플랜)
• 엔드포인트: https://mind-guide-mcp.onrender.com/mcp
• PlayMCP: playmcp.kakao.com 등록 완료

---

위기 연락처

전화	번호	운영
자살예방상담전화	109	24시간 무료
정신건강위기상담전화	1577-0199	24시간 무료
보건복지상담센터	129	24시간 무료
청소년전화	1388	24시간 무료
응급	119	24시간