Safesign

카카오 AGENTIC PLAYER 10 출품작 · 계약서 건강검진 MCP 사인하기 전에, 30초 건강검진.

계약서·약관을 **안전도 점수·등급(A~F)**으로 진단하고, 독소조항·빠진 보호장치를 잡고, 실제 분쟁 다발 유형과의 일치도·예상 피해·권장 수정안까지 더해 건강검진 카드 한 장으로 돌려주는 MCP 서버입니다. ("AI가 계약서 읽어줌"이 아니라 "사인 전 30초 건강검진"입니다.)

왜 다른가 (ChatGPT로는 불가능)

🩺 안전도 점수·등급	계약을 100점 만점 + A~F 등급으로. "내 전세계약 62점 ㄷㄷ"이 카톡에 퍼집니다.
🚨 분쟁 다발 유형 매칭	"이 조항, 전세 보증금 반환 지연 분쟁에서 자주 등장하는 유형" + 예상 피해 + 권장 수정안.
🏠 시세 교차검증	국토부 실거래가로 깡통전세(전세가율) 를 데이터로 판정 (전국 시군구 268곳).
⚖️ 검증된 조문 원문	위험마다 실제 조문 원문 인용(국가법령정보센터). 환각 방지 — 판정은 룰, 추출은 LLM.
🔎 누락 역탐지	"있는 위험"이 아니라 "없어서 위험한 것"(확정일자·보증보험 특약 등)을 잡습니다.

빠른 시작

npm install
npm start                  # MCP 서버 + 데모: http://127.0.0.1:8787
# →  /            카카오톡 스타일 데모 (샘플 1탭 체험)
# →  /health      배포 프로브
# →  POST /mcp    MCP (tools/list, tools/call)
npm test                   # 도메인·서버 e2e (전 테스트 통과)
npm run typecheck

도커(카카오 클라우드 배포):

docker build -t safesign-mcp . && docker run -p 8787:8787 --env-file .env safesign-mcp

배포·등록: docs/deploy/kakao-cloud.md · docs/deploy/playmcp-registration.md

분석 호출(예):

curl -X POST http://127.0.0.1:8787/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyze_contract","arguments":{"text":"<계약서 텍스트>"}}}'

MCP 도구

• analyze_contract — 텍스트·사진(비전 OCR)·PDF 무엇이든 입력 → 안전도 점수·등급 + 위험조항 + 분쟁유형/예상피해 + 검증조문 + 임대차 깡통전세(전세가율) + 카드 PNG URL
• situation_guide — "○○할 때 뭐 봐야 해?" → 원룸/전세/오피스텔·교통사고·병원·보험청구·중고거래·대출 등 상황별 체크리스트·챙길서류·확인사항·함정
• explain_for_family — 부모님·친구에게 설명하듯 어려운 용어 없이 쉬운 말로 풀어주는 요약
• explain_term — 확정일자·대항력·제소전화해 등 용어 평이 설명
• suggest_negotiation — 불리 조항에 대한 요구·수정 문구 생성

안전·책임

법률 자문이 아닌 참고용 1차 점검입니다. 모든 응답에 면책 + 전문가 확인 CTA를 포함하며, 개인정보(PII)는 기본 비저장 + 경계 마스킹합니다.

문서

• 출품 한장 요약: docs/SUBMISSION.md
• 3분 데모 시나리오: docs/demo-scenario.md
• 운영 지침: CLAUDE.md
• 제품 정의: docs/PRD.md
• 구현 일정: docs/IMPLEMENTATION_PLAN.md
• 법률 검증 로그: docs/legal/verification-log.md
• 서브에이전트: .claude/agents/

아키텍처

MCP 도구 → Express(Streamable HTTP) → 도메인(순수 룰엔진: 판정) ← 서비스(비전추출/카드)

판정 로직은 src/domain/(결정론·테스트 가능)에, 부수효과(LLM/저장/HTTP)는 src/server·src/services에. 스택은 moyo에서 검증된 TS ESM + MCP SDK + @resvg(한글 카드) + zod + vitest.