법률 절차 길잡이 (legal-navigator-mcp)

일반인을 위한 생활법률 정보·절차·표준서식·법령·판례 안내 MCP 서버. 57개 분야 · 268개 주제 — 노동(임금·해고·괴롭힘·성희롱·직업훈련)·주택/상가임대차·돈거래/사기·소비자·교통사고·민사/형사 절차·가정폭력·성범죄·스토킹·디지털성범죄·명예훼손·가사/상속·채무조정·금융사기·학교폭력·산업재해·행정·의료·조세·계약·부동산·출입국·보험·지식재산·아동/노인학대·고용보험·공동주택·통신/개인정보·군·선거·환경·반려동물·외국인/이주민·청소년/미성년·장애인·북한이탈주민·플랫폼/특수고용·국가유공자/보훈·복지/취약가구·농어업인·노인/고령·정신건강·범죄피해자·자살예방/유족·재난/안전·소상공인·출소자/갱생보호·위기임신/보호출산·공적연금/사회보험·육아/보육·주거복지·교육/학자금(취약계층·위기·복지급여 '혼자 신청하기' 60여 주제) 등.

⚠️ 개별 법률 자문 도구가 아닙니다. 정보·절차·표준서식·법령·검증된 판례 안내만 제공합니다(declaw). → BOUNDARIES.md

카카오 AGENTIC PLAYER 10(MCP 공모전) 출품용. 표준 원격 MCP(Streamable HTTP, stateless) 라 PlayMCP 개발가이드 규격을 준수하며 Claude·ChatGPT·카카오톡(PlayMCP)에 그대로 붙는다. 본선 배포·메타정보·Preview 체크 → KAKAO_TOOLS_FINAL.md 예선 제출 기록·비즈폼 답안 → SUBMISSION.md

실행

npm install
npm run dev          # http://localhost:4100/mcp  (Streamable HTTP, stateless)
npm run typecheck
npm test             # vitest 225개 (계산 결정성·데이터 불변식·인용검증 회귀·통합)
npm run build && npm start

Related MCP server: haki-ya-kazi-mcp

도구 (16종)

PlayMCP 규격 준수: 영문 tool name · annotations 5종 · description 국문+영문 병기([EN] 줄, 서비스명 영문/국문 병기) · ≤1024자. 전부 인메모리(외부 API 핫패스 미사용).

모든 응답에 면책 고지(출처 원문 링크 + 전문가/법률구조공단 132 에스컬레이션)가 자동으로 붙는다.

데이터 규모

• 268개 주제 / 57개 분야 — src/data/*.ts(분야별 분리) → index.ts 병합

• 판례 194건(고유 184, 판례 보유 주제 154/268, 2020년 이후 72건). 각 사건번호는 law.go.kr·casenote.kr 판결문 실열람 검증분만 수록 — 미검증·없는 판례는 지어내지 않음. ★전 사건번호를 casenote·law.go.kr로 전수 재검증해 미실존 3건 제거·오기 2건 정정(자동 회귀 테스트로 재발 차단)

• 법률용어 125개(src/data/glossary.ts, 9개 분류 — easylaw.go.kr·law.go.kr·대법원·헌재 본문 검증, 형제자매 유류분 위헌 등 최신 반영)

• 표준서식 121종 · 법령 요지 262건 · 법률용어 125개

권장 사용 흐름

사용자 상황(자연어) → triage / search_topics 로 주제 식별
  → get_procedure(절차·기한) · get_checklist(서류) · get_form_template(빈 서식)
  → get_precedent(판례) · verify_citation(인용 진위) · law_updates(시점법)
  → calculate_amount(금액) · calculate_court_cost(소송비용) · calculate_deadline(기한)
  → find_legal_aid(무료 변호사·구제금 연결 + 신청절차·준비서류) · how_to_get_document(준비서류 떼는 법)
  → 모르는 용어가 나오면 explain_term(법률용어 풀이 — 각하·가압류·통상임금, 떼인 돈→대여금)

PlayMCP 규격 준수 체크 (개발가이드 2026.06.12)

• ✅ Streamable HTTP · Remote · Stateless(no session)

• ✅ 프로토콜 2025-06-18 (허용 범위 2025-03-26 ~ 2025-11-25)

• ✅ tool name 영문/숫자/-/_, 중복 없음, 16개(권장 3~10 대비 초과분은 계산기 3종·검증 2종 등 스키마가 달라 분리가 호출 정확도에 유리한 도구들 — list_topics는 search_topics에 통합, check_elements는 해당성 질문 전용)

• ✅ annotations(title·readOnlyHint·destructiveHint·openWorldHint·idempotentHint) 전부 지정

• ✅ description 국문+영문 병기(각 도구에 [EN] 영문 요약 1줄) + 서비스명 영문/국문 병기, 1024자 이내(최장 738자)

• ✅ 이름에 'kakao' 미포함

• ✅ 응답 인메모리 → 평균 <100ms (외부 API는 핫패스에서 미사용)

동작 확인 (curl)

curl -s -X POST http://localhost:4100/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"triage","arguments":{"situation":"전세 만기인데 집주인이 보증금을 안 줘요"}}}'

제출 전 MCP Inspector로 표준 준수 최종 점검 권장: npx @modelcontextprotocol/inspector → URL http://localhost:4100/mcp.

배포 (PlayMCP in KC)

카카오 클라우드 PlayMCP in KC에 Git 소스(이 레포 + Dockerfile) 또는 컨테이너 이미지로 등록 → Endpoint URL 획득. 로컬 검증:

docker build -t legal-navigator-mcp .          # 또는
npm run build && PORT=8080 node dist/server.js  # 컨테이너 CMD와 동일

자세한 등록·심사·접수 단계 → SUBMISSION.md

로드맵

• 생활법률 전 분야 확장 — 57개 분야 268개 주제(취약계층·위기·복지급여 '혼자 신청하기' 60여 주제 포함 — 외국인노동자·이주여성·청소년·장애인등록/연금·북한이탈주민·플랫폼특수고용·국가유공자·기초생활·한부모·농어업인·노인장기요양·정신건강·범죄피해자·자살예방/유족·재난안전·소상공인·출소자·위기임신·국민연금·근로장려금·재난적의료비·산정특례·주거급여·청년월세·아동수당·난임·국가장학금·내일배움카드·청년자산형성·에너지바우처·아이돌봄·소년보호 등)

• 검증된 판례 DB(get_precedent) — 194건, law.go.kr/casenote 실열람 검증(전 사건번호 전수 재검증)

• 법령 공식 deep-link grounding (get_statute)

• 자연어 검색·트리아지(search_topics·triage)

• 인용 검증·시점법(verify_citation·law_updates) — 환각 차단

• 무료지원·구제 신청서 빈칸 채움 골격 23종(src/data/apply_forms.ts) — 소송구조·구조금·대지급금·분쟁조정·전세사기·채무조정 + 사회보장급여·자립수당·국가유공자 등록·산재 요양급여·외국인 사업장변경 + 노란우산 공제금·갱생보호·행정심판 청구·정보공개 청구·의료분쟁 조정 + 장애인 등록·국민연금 유족/장애연금·근로/자녀장려금·재난적의료비 지원. declaw 경계 유지, 공식양식 출처·작성요령 동봉

• 서식 파일 내보내기 — GET /forms/:key.txt(읽기전용·무상태) + get_form_template 응답의 📎 파일로 저장·공유 링크. 받은 .txt를 구글 드라이브·카카오톡 '나에게 보내기'·메일로 공유. 링크 호스트는 요청에서 도출(X-Forwarded-*/PUBLIC_BASE_URL)

• 서식을 한글(.hwpx)·워드(.docx)로 내보내기 — 채운 값 그대로 담은 진짜 문서 파일을 브라우저에서 만든다(서버로 아무것도 보내지 않음). .hwp는 한컴의 비공개 바이너리라 만들 수 없고, .hwpx는 같은 문서를 담는 국가표준(KS X 6101, OWPML)이라 한글 2014 이상에서 그대로 열린다. 구조는 실물 .hwpx를 뜯어 맞췄고(src/hwpx.ts 주석 참고), 회귀 테스트 9종이 지킨다.

• 법률용어 풀이 사전(src/data/glossary.ts, 125개·9분류) — 일상어↔법률어 + 헷갈리는 쌍 구별, easylaw·law.go.kr·대법원·헌재 검증. explain_term 도구

• 원문 연결 강화 — get_precedent 사건번호별 casenote 딥링크, get_statute에 더 깊은 원문(조문 전문·신구조문) 안내

• 자동 테스트(test/, vitest 225개) — 계산 결정성·데이터 정합성 불변식·할루시네이션 재발 가드(미실존 사건번호·비표준 조문)·코드리뷰가 잡은 버그 회귀·통합(도구 규격·면책·다운로드)

• 판례 전수 재검증 — 전 사건번호를 casenote·law.go.kr로 대조(미실존 3건 제거·오기 2건 정정), 회귀 테스트로 재발 차단

• [~] 법제처 국가법령정보 Open API 라이브(src/lawapi.ts, LAW_OC 키 필요·선택, 응답속도 위해 핫패스 미사용)

• 가이드형 서식 작성 인터뷰(대화로 빈칸 한 칸씩 채우기, declaw 경계 유지)