io.github.seojaehongPublished by GitHub account seojaehongv0.6.0Updated Nov 4, 2026
Korean workers' compensation claims: required KCOMWEL forms and articles; fills official PDF forms.
Korean workers' compensation helper: lists required KCOMWEL forms and legal articles, and fills official PDF or HWPX claim forms.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.seojaehong%2Fsanjae-apply/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"sanjae-apply": {
"type": "http",
"url": "https://sanjae-apply.vercel.app/api/mcp/mcp"
}
}
}산재 신청 도우미 · MCP 서버 + CLI
급여 종류와 재해 상황을 말하면 필요한 서식·첨부·근거 조문을 알려 줍니다. 근로복지공단 정본 PDF 12종과, 관할 지방고용노동관서에 내는 산업재해조사표도 그 자리에서 채워 줍니다.
[release] [license] [node] [MCP] [tests] [mcptry]
[합성 값으로 채운 요양급여신청서. 왼쪽 PDF 출력, 오른쪽 한글(hwpx) 출력]합성 값으로 채운 요양급여신청서. 왼쪽이 PDF 출력, 오른쪽이 한글(.hwpx) 출력을 한글에서 연 모습입니다.
산재보험은 청구주의입니다. 재해자나 대리인이 급여 종류마다 다른 서식과 첨부를 직접 챙겨야 합니다. 이 도구는 그 「챙기는 일」을 돕습니다.
[!IMPORTANT] 승인 여부는 다루지 않습니다. 결과의
READY_TO_SUBMIT은 「제출할 수 있는 상태」이지 승인이 아닙니다. 결과를 점치는 표현은 코드 필터가 출력 단계에서 막습니다.
[!NOTE] 입력값을 저장하지 않습니다. 로컬 설치는 PC 밖으로 아무것도 보내지 않습니다. 주민등록번호 같은 칸은 비워 두고 출력한 뒤 손으로 적어도 됩니다.
Node.js 20 이상만 있으면 됩니다. 단계별 따라 하기와 문제 해결은 사용 매뉴얼에 있습니다.
claude_desktop_config.json 에 추가합니다.
cmd /c 로 감쌉니다.
같은 command / args 를 각 도구의 MCP 설정에 넣습니다. stdio 전송이면 전부 됩니다.
붙이고 나서 AI 에게 이렇게 말해 보세요.
「출퇴근 중 교통사고인데 상대 운전자가 있어요. 요양급여 신청하려면 뭐가 필요해요?」 「요양급여신청서에 이 값으로 채워서 PDF 로 줘.」
values.json 의 칸 이름은 catalog <FORM_ID> 결과의 slots 에 나옵니다. PDF 와 한글은 칸 이름이 같습니다. 서식이 갱신되면 npx -y sanjae-apply@latest 로 받습니다.
--stamp 이름 이면 성명인(원형 기본, --stamp-shape square|ellipse)을 만들어 찍고 --stamp-png 면 가진 도장 PNG(투명 배경, 4096px 이하)를 검사한 뒤 그대로 찍습니다. 인주색 적색, 지름 42pt(약 1.5cm). 동봉 글꼴(나눔고딕)에 없는 글자(한자 등)는 빈 도장이 되지 않도록 오류로 멈춥니다. 그런 이름은 --stamp-png 로 가진 도장을 넣어 주세요.catalog <FORM_ID> 의 stamps 에 이름이 나옵니다. 비우면 신청인 본인 자리 전부(applicant 본문 · delegation 위임장 · consent 개인정보 동의)에 찍고 --stamp-spot a,b 로 고릅니다. 타인 서명란(confirm 확인자 · commute_reporter 신고인 · choice_confirmer 등)은 이름을 적어 줄 때만 찍습니다. 지도에 없는 자리는 건너뛰고 결과의 stamps_skipped 에 적습니다.forms/hwpx/). 채울 때는 한글이 필요 없습니다. zip 안 XML 의 표 칸에 값을 넣는 순수 TypeScript 입니다. 윈도우·맥·리눅스 어디서나 돕니다.docs/한글지도_작성법.md 에 있습니다.산업재해조사표 쓰는 법과 관할 데이터는 docs/산업재해조사표_작성방법.md, data/labor-offices/README.md.
sha256 에 묶여 있어 서식이 바뀌면 시험이 먼저 깨집니다.같은 도구 8개가 원격으로 돕니다. 입력은 서버에 저장되지 않지만 네트워크를 거칩니다.
이 레포를 Vercel 에 올리고 환경변수를 넣으면 /api/mcp/mcp 가 열립니다.
전부 합성 값으로만 돌렸습니다. 실제 사건으로는 검증하지 않았습니다.
설치부터 활용까지 따라 하는 사용 매뉴얼과 실측 기록은 docs/사용_매뉴얼.md 에 있습니다.
새 서식의 좌표 지도는 docs/좌표지도_작성법.md, 한글 지도는 docs/한글지도_작성법.md, 배포·연결 전체는 docs/패키징_배포_연결_가이드.md.
catalog 로 개정일을 한 번씩 확인하세요.docs/좌표지도_작성법.md, 한글 지도는 docs/한글지도_작성법.md 를 따라 만들고 test/samples/ 에 합성 값을 함께 넣어 주세요.MIT. 동봉 글꼴 나눔고딕은 SIL OFL 1.1(fonts/OFL.txt). 공단 서식 PDF 는 근로복지공단 공개 자료이고, 산업재해조사표는 법제처 국가법령정보센터에 실린 법령 서식입니다. 관할 관서 연락처는 고용노동부 누리집 관서 안내 화면에서 확인한 공개 정보입니다(직원 성명 없음).
Source: README.md at commit 433dabb
필요 서식·첨부 목록
산재 보상 청구(요양·휴업·간병료이송비보조기·장해·유족·미지급·추가상병·재요양·본인부담치료비)에 필요한 서식(REQUIRED/CONDITIONAL/NOT_APPLICABLE)·첨부(PROVIDED/MISSING/SUBSTITUTABLE)·근거 조문·절차 안내·아직 답해야 할 질문을 돌려준다. 입력을 저장하지 않는다. READY_TO_SUBMIT 은 제출 가능이지 승인이 아니다.
havetagsclaimrequiredthirdPartyrequiredaccidentKindrequiredtreatmentEndedrequired서식 정본 대장(근로복지공단 + 고용노동부 산업재해조사표)
근로복지공단 서식자료실에서 받은 산재보험 서식 13종과, 법제처에서 받은 산업재해조사표(산업안전보건법 시행규칙 별지 제30호서식 — 근로복지공단이 아니라 관할 지방고용노동관서에 내는 서식)의 파일명·개정일·sha256·출처 URL 과, 지금 채울 수 있는 서식(fillable)과 그 칸 이름(slots)·칸 설명(slot_labels, 서식 원문 글자)·도장 자리 이름(stamps). form_id 를 주면 그 서식만. fill_form 전에 이것으로 칸을 고른다.
form_id서식 채우기(정본 PDF 오버레이 · 한글)
form_id 의 정본 서식에 값을 넣어 base64 로 돌려준다. format='pdf'(기본)는 정본 PDF 오버레이, format='hwpx'는 한글 문서(한글 2014+ 로 열어 고칠 수 있다). 먼저 get_form_catalog(form_id) 의 slot_labels 로 칸을 고른다(칸 이름은 두 형식이 같다). 서식의 선택지(사업주여부·친인척여부·근로자유형·신청 구분·예/아니오·개인정보 동의 등)는 해당 체크 칸에 true 를 넣어야 찍힌다. 아는 값은 빠짐없이 넣는다. 서버에 저장하지 않는다. 주민번호 등은 보내지 않아도 된다(빈칸으로 남는다). 사용자가 도장·날인·인감을 말하면 stamp 를 넣는다(넣지 않으면 서명란이 빈다). F_INDUSTRIAL_ACCIDENT_REPORT(산업재해조사표)는 고용노동부(관할 지방고용노동관서)에 내는 서식이다 — 서술 칸은 get_accident_report_guide 로 쓰고 check_accident_report 로 점검한 뒤 채운다. 칸이 모자란 서술은 칸에 「(별지에 적음)」을 쓰고 끝에 별지 쪽을 붙인다(report.annexed). 도장 기본 자리는 사업주(applicant)이고, 근로자대표 확인란(worker_rep)은 근로자대표 본인 것만 spot='worker_rep' 로 따로 찍는다. 결과의 labor_office 에 workplace_address 로 찾은 관할 관서·접수 부서·전화·팩스·확인방법(find_labor_office 와 같은 내용)과, labor_office 칸에 적은 값·제안 값(slot)을 붙인다. 건설업 칸(발주자·원수급·현장명·공사종류·공정률·공사금액)에 값이 있으면 건설 전담 과로 찾는다.
stampformatvaluesrequiredform_idrequired산업재해조사표 작성 지침(읽기 전용)
산업재해조사표(산업안전보건법 시행규칙 별지 제30호서식, 관할 지방고용노동관서 제출)의 제출 의무·기한(발생일부터 1개월)·근로자대표 확인·중대재해 즉시 보고·과태료(시행령 별표 35), 칸별 작성법, 서술 칸(재해발생 개요·원인·재발방지 계획)의 요소·점검표·서식 작성예시, 업종·직업 분류코드 찾는 곳, 자주 틀리는 것, 제출 경로를 근거·확인일과 함께 돌려준다. 문장은 쓰지 않는다 — 호출한 AI 가 사업장이 준 사실로 쓴다. workplace_address 를 주면 관할 관서·접수 부서·전화·팩스 찾기 결과(find_labor_office 와 같은 내용)를 labor_office_lookup 으로 붙인다. 입력을 저장하지 않는다.
sectionconstructionworkplace_address관할 노동관서·산업재해조사표 접수 부서 찾기(읽기 전용)
사업장 주소로 관할 지방고용노동관서(「고용노동부와 그 소속기관 직제 시행규칙」 별표 1 관할 구역)와 산업재해조사표를 받는 부서의 전화·팩스·부서 주소·출처(고용노동부 누리집 관서 화면)·확인방법(공식 직접 확인 / 두 리서치 일치 / 단일 출처 / 미확인)을 돌려준다. 근로복지공단이 아니다. status: CONFIRMED(관서 하나) / CANDIDATES(시도가 빠져 같은 이름 시군구가 여럿이거나 칠곡군 석적읍처럼 법령이 읍·리 단위로 가르는데 주소에 그 단위가 없음 — 하나로 추정하지 않는다) / NOT_FOUND. 지방청 직할 구역은 접수 과가 확정되지 않아 산재예방감독과(기본)와 광역산재예방감독과(보조) 번호를 함께 주고 confirm_before_submit='제출 전 전화 확인 권장'을 붙인다. 관서 화면에서 직접 확인하지 못한 팩스(여수지청 0503-8803-0638, 단일 출처)는 fax_check='확인 필요'와 같은 표시·확인방법을 낸다. labor_office_value 는 서식 「( )지방고용노동청장(지청장) 귀하」 괄호 값 제안이다(칸에 자동으로 넣지 않는다). 팩스를 보내지 않는다. 직원 성명은 없다. 입력을 저장하지 않는다. 데이터 확인일은 data.checked_at.
addressrequiredconstruction산업재해조사표 값 점검(읽기 전용)
fill_form(form_id='F_INDUSTRIAL_ACCIDENT_REPORT') 에 넣을 values 를 점검한다 — 빈 칸, 하나만 고르는 칸(국적·고용형태·근무형태·발주자), 외국인 체류자격, 업종·직업 코드 자릿수, 날짜와 요일 일치, 24시 범위, 입사일·작성일 앞뒤, 휴업 3일 기준, 사망이면 중대재해 즉시 보고 안내, 근로자대표 확인, 원인 칸 4요인·재발방지 계획 기한·담당 단서, 기한 참고일(발생일부터 1개월, 민법 제157·160조). issues 를 error·warn·info 로 돌려준다. 고치지 않고 판단하지 않는다(산업재해 해당 여부·책임은 다루지 않는다). 입력을 저장하지 않는다.
todayvaluesrequired도장(인영) PNG 만들기
이름으로 성명인(원형·사각·타원) 또는 법인형(원주 법인명 + 중심 문자 + 하단 부문자) 도장 PNG(투명 배경)를 만들어 base64 로 돌려준다. 본인 또는 명의자 동의가 있는 이름만 쓴다. 등록 인감을 흉내 내는 용도가 아니다(사용인감 성격). fill_form 의 stamp.name 으로 바로 찍을 수도 있다.
nameshapearc_textinner_ringbottom_textcenter_text요양급여신청서(별지 제2호, 2026.7.7 개정) 채우기
fill_form(form_id='F_YOYANG_APPLY') 과 같다. 칸 이름: name, rrn, address, mobile, phone, accident_datetime(YYYYMMDDhhmm), hire_year/month/day, work_start, work_end, job, claim_kind_accident|disease|commute, worker_type_employee, employer_name, owner_name, workplace_phone, workplace_no(11자리), workplace_address, narrative, police_yes|no, fire_yes|no, insurer_yes|no, witness_name|phone|relation, apply_year|month|day, applicant_name
valuesrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --scope user sanjae-apply -- npx -y sanjae-apply mcp{ "mcpServers": { "sanjae-apply": { "command": "npx", "args": ["-y", "sanjae-apply", "mcp"] } }}{ "mcpServers": { "sanjae-apply": { "command": "cmd", "args": ["/c", "npx", "-y", "sanjae-apply", "mcp"] } }}# 필요 서식·첨부·근거 조문npx -y sanjae-apply check YOYANG --accident COMMUTE --third-party yesnpx -y sanjae-apply check JANGHAE --tags NOISE_HEARING_LOSS --json
# 서식 정본 대장과 채울 수 있는 칸 이름npx -y sanjae-apply catalog F_YOYANG_APPLY
# 공단 정본 PDF 위에 채우기npx -y sanjae-apply fill F_YOYANG_APPLY values.json --out 신청서.pdf
# 같은 값을 한글 문서(.hwpx)로. 확장자만 바꾸면 됩니다npx -y sanjae-apply fill F_YOYANG_APPLY values.json --out 신청서.hwpx
# PDF 에 도장까지. 이름만 주면 성명인을 만들어 신청인 서명란 전부에 찍습니다npx -y sanjae-apply fill F_YOYANG_APPLY values.json --out 신청서.pdf --stamp 홍길동npx -y sanjae-apply fill F_YOYANG_APPLY values.json --out 신청서.pdf --stamp-png 내도장.png --stamp-spot applicant
# 도장 PNG 만 따로 (성명인 · 사각 · 타원 · 법인형)npx -y sanjae-apply seal --out 도장.png --name 홍길동npx -y sanjae-apply seal --out 직인.png --shape ellipse --arc "주식회사 가나다" --center 대표이사 --bottom 123-45-67890claude mcp add --transport http --scope user sanjae-apply https://sanjae-apply.vercel.app/api/mcp/mcp \ --header "Authorization: Bearer <발급받은 토큰>"git clone https://github.com/seojaehong/sanjae-apply && cd sanjae-applynpm ci && npm test
# 채운 PDF 를 글자 위치 + 픽셀로 검사python scripts/verify_fill.py out.pdf forms/maps/F_YOYANG_APPLY.json test/samples/F_YOYANG_APPLY.json out.jpg forms/bundled/F_YOYANG_APPLY.pdf
# 채운 한글 파일을 검사 (한글이 있는 윈도우면 실제 렌더까지, 없으면 --no-render)python scripts/verify_hwpx_fill.py out.hwpx test/samples/F_YOYANG_APPLY.json forms/hwpx_maps/F_YOYANG_APPLY.json out.jpgsrc/core 규칙 S-01~S-13 · 서식/첨부 카탈로그 · 금지어 필터(순수 TS, IO 없음)src/fill overlay.ts pdf-lib 오버레이(text / boxes / check / multiline) hwpx.ts 한글 hwpx 채우기(cell / after / check / digits / boxes / group, 글자색·크기 교정)src/stamp seal.ts 도장 PNG 생성(글리프 윤곽 래스터) · resolve.ts 자리 선택. PDF·hwpx 날인은 overlay.ts·hwpx.ts 의 stampssrc/accident 산업재해조사표 지침(guide.ts) · 값 점검(check.ts) · 관할 관서 찾기(jurisdiction.ts)src/mcp 도구 8개 · 원격(mcp-handler, Bearer) · 로컬(stdio)src/laws 법제처 Open API 클라이언트data/ labor-offices/ 관할(직제 시행규칙 별표 1)·관서 49곳 조사표 접수 부서 연락처(확인일 2026-11-04)api/mcp Vercel 함수web/ 안내 페이지 스크립트(engine.ts = src/core 브라우저 번들 · main.ts = 화면). npm run build:web → public/app · public/dataforms/ catalog.json(정본 대장) · maps/(PDF 좌표 지도 13) · bundled/(동봉 PDF 13) · hwpx/(변환 hwpx 12) · hwpx_maps/(한글 지도 12)scripts/ comwel_forms.py(서식자료실 수집) · verify_fill.py · probe_form.py · hwp_to_hwpx.py · probe_hwpx.py · verify_hwpx_fill.py · hwpx_stamp_anchors.py(도장 앵커) · verify_hwpx_stamps.py(한글 날인 실측) · mcp_dryrun.mjstest/ vitest 294 (formal_rules.test.ts 전수 10,368건 포함)docs/ 좌표지도 작성법 · 한글지도 작성법 · 패키징·배포·연결 가이드 · 산업재해조사표 작성방법 · SafeClaw 연동 설계