Korean Privacy Law MCP

대한민국 개인정보보호법(PIPA) 을 자연어로 검색·비교·분석·검증하는 MCP 입니다.

법제처 31개 + PIPC 공식 출처 인덱스 2개 + RAG 코퍼스 3개 + 환각 검증 1개 — 총 37개 MCP 도구 가 PIPA·시행령·PIPC 고시·의결례 + PIPC 공식 가이드 4종·상담사례 1,745건 (총 2,202 청크) 을 한 번에 다루면서 개인정보보호법과 관련된 문제해결을 도와줍니다.

개인정보보호법, 이제 AI 와 함께 대화하며 풀어 나가봅시다.

English

만든 이유

대기업·공공기관에는 내부 법무팀이나 CPO 같은 전문 인력이 있어 개인정보보호에 신경을 쓰고 있습니다.

그러나 중소기업·소상공인·약국 같은 곳은 법이라는 보이지 않는 장벽을 넘기 위한 인력·예산이 부족해 사각지대에 놓여 있습니다.

본 MCP 가 개인정보보호법에 대한 접근이 어려운 분들께 조금이나마 도움이 되었으면 좋겠습니다.

v0.8 — 개인정보보호법과 관련법령 그리고 가이드와 상담사례를 한 번에

법제처 OPEN API 31개 wrapper 위에 PIPC 공식 출처 인덱스 2개 + 가이드·상담사례 RAG 3개 + 4계층 환각 검증 1개 — 총 37개 도구가 한국 법령 정보 + PIPC 공식 자료를 자연어로 검색·비교·분석.

주요 개발 사항

• PIPC 공식 RAG 코퍼스 2,202 청크 — 법제처 API 가 못 가진 실무 자료. 4종 가이드 457청크 (질의응답 99 + 소상공인 41 + CCTV 71 + 분야별 안내서 246) + 개인정보 포털 상담사례 1,745건. Anthropic Contextual Retrieval 적용. 부팅 시 BM25 인덱스 메모리 빌드 (한국어 토크나이저, prefix + fuzzy 0.2).

• PIPC 공식 출처 인덱스화 (큐레이션 0) — 「분야별 개인정보 보호 안내서」(PIPC, 2024.12) 8개 분야 정형 표 + 개인정보 포털 (privacy.go.kr/contsNo=116·117) 12 법령·23 행정규칙 lookup. 우리 의견·매핑 0 — PIPC 공식 표·portal list 그대로. 모든 응답에 출처·페이지·발간일·"추가 검토 필수" 면책 자동 첨부.

• 4계층 위임 추적 — get_three_tier(법-시행령-시행규칙) + get_delegated_laws + 행정규칙 검색을 묶어 PIPA 조문 → PIPC 고시까지의 위임 경로를 자연어 한 줄로 추적.

• 시점 분기 처리 — get_historical_law·get_article_change_history·get_law_history 로 정통망법 → PIPA 흡수 시점, 개정 전후 본문, 옛 조문 인용 검증.

• PIPC 의결례 검색·계단식 축약 — 1만자+ 평균 의결문 본문을 앞 800자 + 중략 + 뒤 400자로 축약. case-sensitive 응답 quirk (<Ppc> vs <ppc>) 처리.

• 4계층 환각 검증 — verify_pipa_citation 이 법령명 → 조 → 항 → 호·목 순서로 인용 검증. 환각 시 [HALLUCINATION_DETECTED] + 단계별 ✗ + 다음 도구 안내. as_of YYYYMMDD 로 시점별 본문 검증 (예: 2019년 정통망법 §22 가 그 시점에 유효했는지).

• 응답 baseline 표준화 — [NOT_FOUND] / [HALLUCINATION_DETECTED] / [OUT_OF_SCOPE] / [NOT_FOUND_SCOPE] 4종 머신 파싱 마커 + 정규 URL (📎 출처: ...) + 다음 도구 후보 자동 첨부 (체인 없이도 LLM 이 자연스럽게 이어감).

• 법령 약칭 17종 자동 인식 — PIPA·개보법·정통망법·신정법·위치정보법·통비법·정보공개법·전자정부법 등. 법제처 lsAbrv 사전이 도메인 약칭 거의 미수록이라 PRIVACY_ALIASES 가 보완.

예시 — 자연어 한 줄로 도메인 깊이까지

"의료기관에서 환자 개인정보 처리할 때 어떤 법이 우선이야?"

→ AI 가 자연어 질의를 받으면 자동으로 다음을 수행:

• get_sectoral_related_laws("의료기관") — PIPC 분야별 안내서 공식 표 lookup

• official_laws (PIPC 공식 분류) + additional_mentions (본문 빈도 통계) 분리 출력

• lex specialis 원칙 PIPC 직접 인용 + 출처·페이지·발간일 + "추가 검토 필수" 면책 자동 첨부

결과 예시:

"「개인정보 보호법」은 일반법(general law), 의료법은 환자 개인정보에 관한 한 특별법(lex specialis) 입니다. PIPC 도 「분야별 개인정보 보호 안내서(2024.12)」 의료기관 편 FAQ 에서 이를 명시했습니다 — 「의료법」에 규정이 있으면 「의료법」이, 없으면 「개인정보 보호법」이 적용됩니다."

"개인정보 보호법 §28-2 가명정보 처리 조항이 2020년 6월 시점에 유효했어?"

→ AI 가 자연어 질의를 받으면 자동으로 다음을 수행:

• verify_pipa_citation(citation="개인정보 보호법 §28-2", as_of="20200601") 호출

• efYd 시점별 본문 조회로 4계층 (법령 → 조 → 항 → 호·목) 단계별 검증

• 성공 시 ✅ + 4계층 ✓ + mst·lawId + 정규 URL / 환각 시 [HALLUCINATION_DETECTED] + 단계별 ✗

결과 예시:

결론: 아니요. 2020년 6월 시점에는 아직 시행 전이었습니다. 이른바 "데이터 3법"(개인정보 보호법·정보통신망법·신용정보법) 개정의 일부로, 2020년 2월 4일 공포 후 6개월의 경과기간을 두고 8월 5일에 발효됐기 때문입니다. 따라서 2020년 6월에 가명정보를 처리하면서 §28조의2를 근거로 삼는 것은 가능하지 않았고, 그 시점에는 가명정보 개념을 직접 규율하는 일반법 조문 자체가 부재했습니다(통계작성·과학적 연구·공익적 기록보존 목적의 가명처리·결합 등 새로운 적법처리 근거는 모두 8.5 이후 개시).

자연어 한 줄로 PIPA 도메인 추적 + 인용 검증을 한 번에.

설치 및 사용법

0단계: API 키 발급 (무료, 1분)

모든 방법에 공통으로 필요한 법제처 OPEN API 인증키(OC) 를 먼저 발급받으세요.

1. 법제처 OPEN API 신청 페이지 접속

2. 회원가입 후 로그인

3. "OPEN API 사용 신청" 버튼 클릭

4. 신청서 작성 → 인증키(OC) 발급 (이메일 ID 형식)

아래 모든 예시의 your-api-key-here 는 placeholder — 본인 발급 키로 교체하세요. (.env.example 와 동일 컨벤션)

방법 1: Claude.ai 웹에서 바로 사용 (설치 없음) 가장 간편

claude.ai 에서 커스텀 커넥터 추가. Claude Pro/Max/Team/Enterprise 요금제 필요 (Free 는 커넥터 1개만 가능).

커넥터 추가 방법:

1. claude.ai 로그인

2. 사이드바 하단 본인 이름 → "설정" → "커넥터"

3. "커스텀 커넥터" 영역 → "커스텀 커넥터 추가"

4. 아래 입력 (your-api-key-here 는 본인 키로 교체):

   • 이름: korean-privacy-law (자유)

   • URL: https://scvcoder-korean-privacy-law-mcp.hf.space/mcp?oc=your-api-key-here

5. "추가" → 등록 완료

도구 활성화 (중요): 등록한 커넥터 "구성" 클릭 → 도구 목록에서 모든 도구를 "항상 사용" 으로 설정. 매번 승인 없이 AI 가 바로 호출 가능.

이제 채팅에서 자연어로:

"개인정보 보호법 제15조 알려줘"                                → 법령 조문 본문
"의료기관 환자 개인정보 처리할 때 어떤 법이 우선이야?"          → PIPC 분야별 매핑
"가족 동의 없이 자녀 사진 SNS 에 올리면?"                       → 상담사례 검색
"개인정보 보호법 §28-2 가 2020년 6월 시점에 유효했어?"           → 인용 조문 시점 검증
"PIPC 가 동의 없는 마케팅 문자 발송에 어떻게 의결했어?"          → PIPC 의결례

Hugging Face 원격 서버는 운영자(scvcoder) 가 무료로 제공하는 베스트 에포트 서비스 — 동작 보장 없음. 본인 운영용으로 직접 배포하려면 docs/HUGGINGFACE.md 참고 (Pro 구독 + 5분 소요).

방법 2: AI 데스크톱 앱에서 사용 (Claude Desktop · Cursor · Windsurf)

설정 파일에 아래 내용 추가 (your-api-key-here 는 본인 키로 교체):

{
  "mcpServers": {
    "korean-privacy-law": {
      "url": "https://scvcoder-korean-privacy-law-mcp.hf.space/mcp?oc=your-api-key-here"
    }
  }
}

설정 파일 위치:

이미 다른 MCP 서버가 설정되어 있다면 "mcpServers": { ... } 안에 "korean-privacy-law": { ... } 부분만 추가. 저장 후 앱 재시작.

방법 3: 내 컴퓨터에 직접 설치 (오프라인 가능)

인터넷 없이 쓰고 싶거나, 원격 서버를 거치지 않으려면 직접 설치할 수 있습니다.

사전 준비: Node.js 버전 18 이상.

자동 실행 (npx, 추천):

설정 파일에 아래 내용 추가:

{
  "mcpServers": {
    "korean-privacy-law": {
      "command": "npx",
      "args": ["-y", "korean-privacy-law-mcp"],
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

매번 npm 캐시 확인 — 새 버전 자동 적용.

글로벌 설치 (부팅 빠름):

npm install -g korean-privacy-law-mcp

설정 파일을 아래로 변경:

{
  "mcpServers": {
    "korean-privacy-law": {
      "command": "korean-privacy-law-mcp",
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

부팅이 0.5~1초 빠릅니다. 새 버전은 npm install -g korean-privacy-law-mcp 로 수동 업데이트.

소스에서 직접 빌드 (개발자):

git clone https://github.com/scvcoder/korean-privacy-law-mcp.git
cd korean-privacy-law-mcp
npm install
npm run build

설정 파일에서 절대경로로 지정:

{
  "mcpServers": {
    "korean-privacy-law": {
      "command": "node",
      "args": ["/절대경로/korean-privacy-law-mcp/dist/index.js"],
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

또는 프로젝트 루트의 .env 파일에 LAW_OC=... 작성하면 자동 로드 — env 블록 생략 가능.

Claude Desktop 단계별 상세 + 트러블슈팅: docs/CLAUDE_DESKTOP.md

앱을 재시작하면 완료!

API 키 전달 방법 정리

여러 방법으로 인증키를 전달할 수 있습니다. 위에서부터 우선 적용됩니다:

사용 예시

법령·행정규칙·결정문·해석례 검색

법령 본문, 시행령·시행규칙·PIPC 고시까지의 위임 관계, 그리고 PIPC 의결례·헌재결정례·해석례를 자연어로 찾아볼 수 있습니다.

"개인정보 보호법 제15조 알려줘"
→ 해당 조문 본문과 법제처 정식 출처 링크를 함께 반환합니다.

"개인정보 영향평가 의무는 어떤 법령에 어디까지 정해져 있어?"
→ 법·시행령·시행규칙·PIPC 고시까지의 위임 경로를 한 번에 정리해 줍니다.

"PIPC 가 동의 없는 마케팅 문자 발송에 어떻게 의결했어?"
→ 관련 의결례를 찾아 핵심 부분을 발췌해 보여 줍니다."

PIPC 공식 분야별 매핑

특정 분야에서 어떤 법이 우선 적용되는지 — PIPC 가 직접 게시한 공식 답변을 출처와 함께 그대로 받아 봅니다. 우리가 가공·해석한 내용이 아니라 PIPC 의 원본 표 그대로입니다.

"병원에서 환자 정보 처리할 때 의료법이랑 개인정보 보호법 중 뭐가 우선이야?"
→ PIPC 「분야별 개인정보 보호 안내서」 의 의료기관 편 답변을 그대로 보여 줍니다.

"개인정보 포털에 등록된 관련 법령·행정규칙 목록 알려줘"
→ privacy.go.kr 에 PIPC 가 직접 등록한 12 법령 + 23 행정규칙 list 를 반환합니다.

지원 분야: 인사·노무 · 사회복지시설 · 의료기관 · 약국 · 학원·교습소 · 통계작성 · 공공기관 · 온라인경품. (병원→의료기관 같은 별칭은 자동 인식)

PIPC 가이드·상담사례 자연어 검색

PIPC 가 발간한 공식 가이드 4종 + 개인정보 포털 상담사례 1,745건을 자연어로 검색합니다. 모든 답변에 PIPC 공식 출처가 첨부되어 검증 가능합니다.

"가족 동의 없이 자녀 사진을 SNS 에 올려도 돼?"
→ 개인정보 포털의 관련 상담사례를 찾아 답변을 보여 줍니다.

"가명정보를 다른 회사 데이터와 결합하려면?"
→ 「개인정보 질의응답 모음집」 에서 해당 항목을 찾아 답변을 보여 줍니다.

"약국에서 처방전 보관할 때 주의할 점"
→ 가이드 4종 + 상담사례를 통합 검색해 가장 관련성 높은 항목을 보여 줍니다.

인용 조문이 진짜 있는지 / 그 시점에 유효했는지 검증

AI 가 답변에서 인용한 법 조문이 실제로 존재하는지, 또는 과거 특정 시점에 유효했는지 를 확인합니다. 인공지능이 그럴듯하게 만들어낸 조문 (환각) 을 잡아내는 안전장치.

"개인정보 보호법 §15 ② 1호가 실제로 있는 조문인지 확인해 줘"
→ 법령·조·항·호·목 단계별로 존재 여부를 검증합니다.

"개인정보 보호법 §28-2 가 2020년 6월 시점에 유효했어?"
→ 그 시점 기준으로 조문이 시행 중이었는지 시점별 본문으로 검증합니다.

법령명은 약칭으로 입력해도 인식합니다 (개보법·정통망법·신정법·위치정보법·통비법 등).

도구 구조 (37개)

전체 도구 상세 (이름·파라미터·예시) 는 docs/API.md 참고.

주요 특징

• 37개 도구 통합 — 법제처 31 + PIPC 공식 출처 인덱스 2 + RAG 코퍼스 3 + 4계층 환각 검증 1.

• 법령 + 관계법령 + 가이드 + 상담사례 — 일반 법령 MCP 가 못 다루는 가이드와 상담사례까지 RAG 코퍼스로 결합해 한 MCP 안에서 한 번에 처리.

• PIPC 공식 자료 RAG 코퍼스 2,202 청크 — 가이드 4종 (질의응답·소상공인 핸드북·CCTV 안내서·분야별 안내서) + 개인정보 포털 상담사례 1,745건. Contextual Retrieval 적용.

• PIPC 공식 출처 100% 인덱스화 — 우리 큐레이션 0. 분야별 안내서·개인정보 포털 등록 법령·행정규칙을 PIPC 게시 표 그대로.

• 자연어 분야 매칭 — 별칭 자동 정규화 (병원 → 의료기관 · 감사 → 공공기관 등 8개 분야).

• 법률 도메인 특화 — 약칭 17종 자동 인식 (PIPA·개보법·정통망법·신정법·위치정보법 등), 조문번호 정규화 (§28-2 ↔ 002802), 4계층 위임 추적 (법-시행령-시행규칙-PIPC 고시).

• 4계층 환각 검증 — 인용 조문이 실제 존재하는지 법령→조→항→호·목 단계별 검증. 시점별 (as_of) 검증으로 옛 조문 인용도 잡아냄.

• 원격 + 로컬 모드 — https://scvcoder-korean-privacy-law-mcp.hf.space 즉시 사용 OR npx korean-privacy-law-mcp 로 로컬 stdio.

• MCP 단일 표준 — Claude.ai 웹 · Claude Desktop · Cursor · Windsurf 어디서든 동일 도구 37개.

• 검증 — 441 cases 자동 테스트 (npm test — 법제처 API 실호출 + 스냅샷, mock 위주 X).

• 라이선스 — MIT (코드).

RAG 원자료 출처 — 개인정보보호위원회 가이드 및 개인정보 포털 상담사례 (https://www.privacy.go.kr/front/case/list.do).

※ 원자료 저작자가 전부 또는 일부의 삭제 또는 수정 요청을 할 경우 즉시 조치하겠습니다.

환경 변수

.env 파일을 프로젝트 루트에 두면 자동 로드. Claude Desktop 처럼 임의 cwd 로 spawn 되는 경우에도 스크립트 디렉터리 기준 ../.env 까지 자동 탐색. 그래도 못 찾으면 stderr 에 경고만 출력 (서버는 기동 — Layer C RAG 검색 등 일부 동작은 키 없이도 가능).

전체 변수 + 예시: .env.example.

문서

라이선스 및 RAG 원자료 출처

MIT (코드)

RAG 원자료 출처 — 개인정보보호위원회 가이드 및 개인정보 포털 상담사례 (https://www.privacy.go.kr/front/case/list.do).

※ 원자료 저작자가 전부 또는 일부의 삭제 또는 수정 요청을 할 경우 즉시 조치하겠습니다.

본 MCP 는 법률 자문이 아닙니다. 개인정보 도메인 자료 검색·비교·분석을 도와주는 도구이며, 구체적 사안의 법적 판단은 전문기관이나 전문가 자문을 받으십시오.

Made by scvcoder