# 🩺 싸인전에 (SafeSign)

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

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

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

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

## 빠른 시작

```bash
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
```

도커(카카오 클라우드 배포):
```bash
docker build -t safesign-mcp . && docker run -p 8787:8787 --env-file .env safesign-mcp
```
배포·등록: [docs/deploy/kakao-cloud.md](docs/deploy/kakao-cloud.md) · [docs/deploy/playmcp-registration.md](docs/deploy/playmcp-registration.md)

분석 호출(예):
```bash
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](docs/SUBMISSION.md)
- 3분 데모 시나리오: [docs/demo-scenario.md](docs/demo-scenario.md)
- 운영 지침: [CLAUDE.md](CLAUDE.md)
- 제품 정의: [docs/PRD.md](docs/PRD.md)
- 구현 일정: [docs/IMPLEMENTATION_PLAN.md](docs/IMPLEMENTATION_PLAN.md)
- 법률 검증 로그: [docs/legal/verification-log.md](docs/legal/verification-log.md)
- 서브에이전트: [.claude/agents/](.claude/agents/)

## 아키텍처

```
MCP 도구 → Express(Streamable HTTP) → 도메인(순수 룰엔진: 판정) ← 서비스(비전추출/카드)
```
판정 로직은 `src/domain/`(결정론·테스트 가능)에, 부수효과(LLM/저장/HTTP)는 `src/server`·`src/services`에.
스택은 moyo에서 검증된 TS ESM + MCP SDK + @resvg(한글 카드) + zod + vitest.