she-mcp

한국 안전·보건·화학 분야 정보를 조회하는 MCP 서버입니다.

• 산업안전보건 법령·행정규칙·법령해석례
• 공단 안전보건법령 스마트검색
• KOSHA GUIDE
• 물질안전보건자료(MSDS)
• 법령 별표·서식

MCP 서버는 사용자의 PC에서 실행되며, API 인증정보는 각 사용자가 직접 발급해 설정합니다.

요구 사항

• Node.js 22 이상
• npm
• 법제처 국가법령정보 Open API OC 값
• 공공데이터포털 일반 인증키(Decoding)

API 키 발급

법제처

국가법령정보 공동활용에서 회원가입 후 OC 값을 발급받습니다.

공공데이터포털

data.go.kr에서 다음 서비스의 활용신청을 합니다.

• 안전보건법령 스마트검색: 15123696
• 물질안전보건자료 조회: 15157612
• 코샤가이드 조회: 15144147

공공데이터포털 키는 반드시 일반 인증키(Decoding) 를 사용해야 합니다.

설치 및 설정

git clone https://github.com/zxc8661/safety-health-chemical-mcp.git
cd safety-health-chemical-mcp
npm install
Copy-Item .env.example .env
notepad .env

.env에 사용자 본인의 인증정보를 입력합니다.

LAW_OC=사용자_법제처_OC
DATA_GO_KR_KEY=사용자_Decoding_서비스키

.env는 Git에 커밋하지 마세요. 저장소에는 .env.example만 포함해야 합니다.

빌드 및 테스트

npm run build
npm test

실제 API 연결을 확인하려면 인증정보를 설정한 뒤 실행합니다.

npm run smoke

smoke는 법령, 스마트검색, KOSHA GUIDE, MSDS API의 응답 구조와 실제 조회 가능 여부를 확인합니다.

Claude Code 연결

로컬 빌드 결과를 MCP 서버로 등록합니다.

claude mcp add --transport stdio she -- node "C:\경로\safety-health-chemical-mcp\dist\index.js"

등록 확인:

claude mcp list

Codex 연결

codex mcp add she -- node "C:\경로\safety-health-chemical-mcp\dist\index.js"

등록 확인:

codex mcp list

MCP 클라이언트에서 다음과 같이 질의할 수 있습니다.

• 산업안전보건법에서 위험성평가 관련 조문을 찾아줘
• 톨루엔의 MSDS 8항과 보호구 정보를 조회해줘
• 밀폐공간 관련 KOSHA GUIDE를 찾아줘

제공 도구

도구	설명
smart_search	안전보건 법령·고시·KOSHA GUIDE 횡단 검색
search_law	법령 검색
get_law	법령 조문 조회
search_admrule	고시·훈령·예규 검색
get_admrule	행정규칙 본문 조회
search_interpretation	법령해석례 검색
get_interpretation	법령해석례 본문 조회
get_annex	법령 별표·서식 조회
search_kosha_guide	KOSHA GUIDE 검색
get_kosha_guide	KOSHA GUIDE 본문 조회 및 캐시
search_msds	MSDS 물질 검색
get_msds	MSDS 항목 조회

캐시

KOSHA GUIDE에서 추출한 Markdown은 다음 경로에 로컬 캐시됩니다.

.cache/kosha/

PDF 원본은 보관하지 않습니다. 캐시 디렉터리는 Git에서 제외됩니다.

보안 및 이용 시 주의

• API 키를 소스 코드, .mcp.json, README, 이슈, 로그에 작성하지 마세요.
• API 키는 사용자별로 발급·관리해야 합니다.
• 법령·고시·KOSHA GUIDE·MSDS의 근거등급은 서로 다르므로 MCP 응답의 근거등급을 확인하세요.
• 결과는 검토 보조 자료이며 최종 법적 판단은 담당자가 확인해야 합니다.

개발 상태

현재 TypeScript 구현과 오프라인 단위 테스트가 포함되어 있습니다. 실제 API 사용 전에는 각 API의 활용신청과 인증정보 설정이 필요합니다.

npm test
12 tests passed

라이선스

별도 라이선스는 아직 지정되지 않았습니다. 공개 배포 전 저장소 라이선스를 확정하세요.