비 오면 피해 MAP MCP

비 오는 날 피해야 할 침수 위험 장소와 주차 위치를 시민 제보, 제보 확인, 신뢰도 기반으로 안내하는 생활안전 MCP입니다.

핵심 기능

• 침수 위험 장소 제보
• 주소/지역 기반 침수 위험 조회
• 폭우 시 주차 위험 조회
• 반지하, 주차, 운전, 저지대 상가 상황별 행동 가이드
• 다른 사용자의 제보 확인
• 현장사진 제보, 최근 촬영시각 표시, 현재 위치 주변 사진 조회
• 사용자가 직접 설정한 관심 지역의 새 제보 브라우저 알림과 현장 소식 공유
• 제보자 신뢰도와 우리동네 기상캐스터 역할 부여
• 기상청 APIHub 초단기예보 기반 강수 참고정보
• 공식 안전정보와 지도 검색 링크 제공

MCP 정보

• MCP server name: rain-avoid-map
• 표시 서비스명: 비 오면 피해 MAP
• 제출용 endpoint: /mcp
• 로컬 데모: /
• 상태 확인: /health
• tool 수: 9개

도구 목록

• report_rain_damage_spot: 침수 위험 장소 제보
• check_rain_damage_risk: 주소/지역 기반 침수 위험 조회
• check_parking_risk_when_rain: 폭우 시 주차 위험 조회
• get_rain_day_avoidance_guide: 상황별 행동 가이드
• confirm_rain_damage_report: 다른 사용자의 침수 제보 확인
• get_local_weather_watchers: 신뢰도 높은 동네 제보자 조회
• get_kma_rain_context: 기상청 초단기예보 강수 참고정보 조회
• get_recent_area_updates: 특정 지역의 최근 시민제보와 확인 소식 조회
• get_official_weather_and_flood_links: 공식 안전정보 링크 제공

로컬 실행

npm install
npm run build
npm start

브라우저 데모:

http://127.0.0.1:3000/

MCP endpoint:

http://127.0.0.1:3000/mcp

상태 확인:

Invoke-RestMethod http://127.0.0.1:3000/health

테스트

npm test

등록용 설명

비 오면 피해 MAP은 이상기후와 국지성 집중호우로 인한 생활 침수 피해를 줄이기 위한 시민참여형 생활안전 MCP입니다. 사용자는 침수된 도로, 주차장, 지하차도, 반지하 주변, 저지대 상가 앞 정보를 주소와 일시 단위로 제보할 수 있고, 다른 사용자는 해당 제보를 확인해 제보자의 신뢰도를 높일 수 있습니다. 반복적으로 확인받은 제보자는 우리동네 기상캐스터 역할을 부여받아 동네 단위 위험 신호를 더 믿고 참고할 수 있게 돕습니다.

본 서비스는 공식 재난문자나 지자체 대피명령을 대체하지 않으며, 비 오는 날 더 빠르게 피하고 대비하기 위한 참고용 생활안전 도구입니다.

기상청 API 키 설정

키는 코드나 채팅에 적지 말고 .env 또는 배포 환경변수에만 설정합니다.

KMA_API_KEY=발급받은_인증키
KMA_API_PROVIDER=apihub
KMA_TIMEOUT_MS=10000

GPS 위치 동의를 받은 사진 제보에 좌표 대신 상세 주소 표기를 함께 쓰려면 선택 환경변수를 설정합니다. 키가 없어도 좌표와 정확도 범위로 제보할 수 있습니다.

KAKAO_REST_API_KEY=발급받은_REST_API_키

지도 화면을 카카오맵으로 표시하려면 JavaScript 키를 별도로 설정합니다. REST API 키가 아니라 JavaScript 키를 사용하며, 배포 주소를 JavaScript SDK 도메인으로 등록해야 합니다.

KAKAO_MAP_APP_KEY=발급받은_JavaScript_키
MAP_PROVIDER=kakao

기본값은 openstreetmap입니다. 카카오맵 SDK 도메인 등록이 완료된 뒤에만 MAP_PROVIDER=kakao로 전환합니다.

사진 제보는 위치정보 저장 동의와 브라우저 위치 권한을 모두 받은 경우에만 정밀 위치를 요청합니다. 위치정보가 없거나 정확도가 낮으면 제보 위치를 넓은 범위로 표시합니다.

배포 후 MCP 응답에서 현장사진을 공개 URL로 제공하려면 다음 값을 배포 주소로 설정합니다.

PUBLIC_BASE_URL=https://발급받은_배포주소

현장사진은 브라우저에서 압축하면서 EXIF 메타데이터를 제거하며, 서버는 JPEG·PNG·WebP 형식과 크기를 다시 검사합니다. 현재 파일 저장소는 MVP용 로컬 디스크이므로 컨테이너 재시작 후 영구 보존은 보장하지 않습니다.