M MCP모아
튜토리얼

화학물질 안전데이터 MCP — MSDS 공공 API를 Claude에 연결하는 가이드

화학물질 안전데이터(MSDS) 공공 API를 MCP 서버로 Claude에 연결하는 방법을 단계별로 안내합니다. 화학 데이터 MCP 서버 설치부터 Claude Desktop 설정까지 완전히 해결하세요.

화학물질 안전데이터(MSDS) 공공 API를 MCP 서버를 통해 Claude에 연결하는 데이터 흐름을 보여주는 표지 이미지

화학물질 안전데이터(MSDS) 공공 API를 MCP 서버로 연결하면, Claude가 수만 종 화학물질의 위험성·성분·취급 주의사항을 대화 흐름 안에서 즉시 조회하고 분석해 줍니다. 별도 코드 없이 자연어 질문만으로 MSDS 전체 항목을 검색하거나, 복수 화학물질을 비교하고, 안전 교육 자료 초안을 생성할 수 있습니다. 이 가이드에서는 공공데이터포털 MCP 서버 모음(data-go-mcp-servers)을 활용해 화학물질 안전데이터 MCP를 Claude Desktop에 연결하는 전 과정을 단계별로 안내합니다.

왜 MSDS 공공 API를 MCP로 연결해야 하나요?

화학물질 안전데이터(MSDS, Material Safety Data Sheet)는 산업안전보건법에 따라 사업장에서 반드시 구비해야 하는 법정 문서입니다. 화학물질안전원은 이 데이터를 공공 API 형태로 공개하고 있어 누구나 활용할 수 있지만, 실제로 활용하려면 API 문서를 읽고 코드를 작성해야 하는 진입 장벽이 존재합니다.

MCP(Model Context Protocol)를 사용하면 이 과정이 크게 단순해집니다. Claude가 MCP 서버를 도구로 활용해 API를 직접 호출하고, 응답 JSON을 사람이 읽기 쉬운 형태로 정리해 줍니다.

[사용자 입력]
    "아세톤의 위험·유해성 정보와 응급 처치 방법 알려줘"
          |
          v
[Claude Desktop]
    의도 분석 → MSDS MCP 도구 선택
          |
          v
[MCP 서버 (로컬 실행 — data-go-mcp-servers)]
    화학물질명 또는 CAS 번호로 파라미터 구성 → HTTP 요청
          |
          v
[화학물질안전원 MSDS 공공 API (data.go.kr)]
    JSON 형태 MSDS 데이터 반환
          |
          v
[Claude Desktop]
    JSON 파싱 → 항목별 정리 → 자연어 요약 → 사용자에게 출력

별도의 파이썬 스크립트나 API 문서 탐색 없이, 대화만으로 MSDS 데이터를 활용할 수 있는 것이 핵심 장점입니다.

MSDS MCP 서버로 할 수 있는 것

활용 시나리오예시 프롬프트
화학물질 위험성 요약”황산의 MSDS 위험·유해성 분류를 요약해줘”
성분 및 물성 조회”메탄올의 끓는점, 인화점, 밀도 알려줘”
응급 처치 정보”염산 피부 접촉 시 응급 처치 절차 알려줘”
복수 화학물질 비교”아세톤과 에탄올의 인화점·위험 등급 비교표 만들어줘”
안전 교육 자료 초안”벤젠 취급 작업자를 위한 안전 교육 자료 초안 작성해줘”

관련 MCP 서버 한눈에 보기

공공데이터 카테고리에서 화학물질 데이터 외에도 다양한 한국 공공데이터 MCP 서버를 찾아볼 수 있습니다.

서버 이름연결 API설치 방식API 키 필요
공공데이터포털 MCP 서버 모음화학물질안전원 MSDS, 국민연금, 국세청, 나라장터 등uvx필요
한국 부동산 MCP국토교통부 실거래가, 청약홈, 온비드stdio (Git 클론)필요
표준국어대사전 MCP국립국어원 표준국어대사전stdio (로컬 SQLite)불필요

준비물

설치를 시작하기 전에 아래 항목을 확인하세요.

항목최소 요구 사항확인 방법
Claude Desktop최신 버전앱 메뉴 > About Claude
Python3.10 이상python3 --version
uv0.4 이상uv --version
data.go.kr 계정회원가입 및 API 활용 신청 완료data.go.kr 마이페이지
MSDS API 서비스 키승인 완료마이페이지 > 개발 계정

uv가 설치되어 있지 않다면 아래 명령으로 설치합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

설치 후에는 터미널을 새로 열거나 source ~/.zshrc(또는 ~/.bashrc)를 실행해 PATH를 갱신하세요.

단계별 설치 방법

1단계: data.go.kr에서 화학물질안전원 MSDS API 키 발급

  1. data.go.kr에 접속해 회원가입 또는 로그인합니다.
  2. 검색창에 “화학물질안전원 MSDS” 를 검색합니다.
  3. 원하는 MSDS API 상세 페이지에서 활용 신청 버튼을 클릭합니다.
    • 활용 목적(예: 연구·개발 자동화, 안전 교육 자료 생성)을 간단히 기재합니다.
  4. 자동 승인 API는 즉시 발급, 심사 필요 API는 2~3 영업일 내 승인됩니다.
  5. 승인 후 마이페이지 > 개발 계정 > 일반 인증키에서 서비스 키를 복사합니다.

서비스 키는 인코딩(URL-encoded) 형태와 디코딩 형태 두 가지로 제공됩니다. MCP 설정에서는 디코딩된 키를 사용하세요.

2단계: Python 및 uv 환경 확인

터미널에서 아래 명령으로 환경을 확인합니다.

python3 --version
# Python 3.10.x 이상이어야 합니다

uv --version
# uv 0.4.x 이상이어야 합니다

uv 버전이 낮다면 아래 명령으로 업데이트합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

3단계: data-go-mcp-servers 실행 준비 확인

공공데이터포털 MCP 서버 모음은 uvx로 별도 설치 없이 바로 실행할 수 있습니다. 화학물질안전원 MSDS API를 포함한 여러 한국 공공 API를 지원합니다.

사용 가능한 모듈 목록과 최신 업데이트는 GitHub 저장소 README를 직접 확인하는 것을 권장합니다.

# uvx 설치 확인 및 모듈 도움말 확인 (예시)
uvx data-go-mcp.nps-business-enrollment@latest --help

위 명령이 정상 동작한다면 uvx 환경이 준비된 것입니다. MSDS 모듈이 별도로 제공되는 경우, 저장소 README의 모듈명을 확인해 동일한 방식으로 실행하면 됩니다.

4단계: Claude Desktop 설정 파일에 MCP 서버 추가

Claude Desktop의 설정 파일을 텍스트 편집기로 엽니다.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

아래 예시를 참고해 mcpServers 항목을 추가합니다. 실제 서비스 키와 모듈명은 저장소 README에서 확인한 값으로 교체하세요.

{
  "mcpServers": {
    "data-go-msds": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_서비스_키_입력"
      }
    }
  }
}

기존에 다른 MCP 서버 설정이 있다면, mcpServers 객체 안에 항목을 추가하면 됩니다. 파일 전체를 덮어쓰지 않도록 주의하세요.

JSON 문법을 확인하려면 아래 명령을 사용합니다.

# macOS 기준
python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

오류 없이 포맷된 JSON이 출력되면 설정 파일이 올바른 것입니다.

5단계: Claude Desktop 재시작 및 MSDS 데이터 조회 확인

  1. Claude Desktop을 완전히 종료합니다. macOS에서는 메뉴바 아이콘까지 확인하세요.
  2. Claude Desktop을 다시 실행합니다.
  3. 새 대화를 열고 아래와 같이 입력해 연결을 확인합니다.
사용 가능한 공공데이터 도구 목록을 알려줘.

연결이 성공했다면 Claude가 등록된 MCP 도구 목록을 나열합니다. 이후에는 아래와 같이 자연어로 MSDS 데이터를 바로 조회할 수 있습니다.

아세톤(Acetone)의 위험·유해성 등급과 응급 처치 방법을 요약해줘.

흔한 오류와 해결 방법

오류 메시지원인해결 방법
spawn uvx ENOENTuv 미설치 또는 PATH 미등록uv 재설치 후 터미널 재시작
API key not found환경 변수 오타 또는 누락설정 파일의 env 키 이름 확인
403 ForbiddenAPI 키 미승인 또는 만료data.go.kr 마이페이지에서 승인 상태 확인
Connection timeout공공데이터 서버 응답 지연잠시 후 재시도, data.go.kr 공지사항 확인
MCP 서버 목록에 미노출설정 파일 JSON 문법 오류JSON 유효성 검사 후 Claude Desktop 재시작
화학물질 검색 결과 없음CAS 번호 또는 화학물질명 표기 문제영문 공식 명칭 또는 CAS 번호로 재시도

화학물질명 검색 팁

화학물질안전원 MSDS API는 검색어 형식에 민감할 수 있습니다. 검색이 되지 않는다면 아래 순서로 시도해보세요.

  1. 한국어 명칭: “아세톤”, “황산”, “에탄올”
  2. 영문 명칭: “Acetone”, “Sulfuric acid”, “Ethanol”
  3. CAS 번호: 67-64-1(아세톤), 7664-93-9(황산), 64-17-5(에탄올)

활용 예시: 실제 MSDS 조회 대화 흐름

아래는 화학물질 안전데이터 MCP를 설치한 뒤 Claude와 나눌 수 있는 실제 대화 흐름 예시입니다.

사용자: 벤젠의 발암성 등급과 노출 기준을 알려줘. IARC 분류도 포함해서.

Claude: [MSDS MCP 도구 호출]
        벤젠 (Benzene, CAS: 71-43-2)
        - IARC 발암성 분류: Group 1 (인체 발암물질)
        - GHS 위험·유해성 분류: 발암성 1A, 생식독성 1A
        - 작업환경 노출 기준(한국): TWA 0.5 ppm
        - 응급 처치 (흡입 시): 신선한 공기로 즉시 이동 후 의료진 상담
        ...

이처럼 연구자·안전 관리자·교육 담당자가 복잡한 API 호출 없이 대화만으로 MSDS 핵심 정보를 빠르게 파악할 수 있습니다.

자주 묻는 질문

화학물질안전원 MSDS API 키는 어디서 발급받나요?

data.go.kr(공공데이터포털)에 회원가입한 뒤, 화학물질안전원 MSDS 관련 API 상세 페이지에서 ‘활용 신청’을 클릭합니다. 자동 승인 API는 즉시 발급되고, 심사 필요 API는 2~3 영업일이 소요됩니다. 발급된 키는 마이페이지 > 개발 계정에서 확인할 수 있습니다.

MSDS MCP 서버를 Claude Code(CLI)에서도 쓸 수 있나요?

네, 가능합니다. Claude Code에서는 ~/.claude/settings.json(전역) 또는 프로젝트 루트의 .claude/settings.json에 mcpServers 설정을 추가하면 됩니다. 설정 형식은 Claude Desktop과 동일합니다.

MSDS 공공 API는 어떤 화학물질 정보를 제공하나요?

화학물질안전원 MSDS API는 물리화학적 특성, 위험·유해성 분류(GHS), 구성 성분, 응급 처치 방법, 취급 및 저장 방법, 노출 기준, 환경 영향 등 MSDS 전 항목을 JSON 형태로 제공합니다.

data-go-mcp-servers가 MSDS API를 정말 지원하나요?

해당 저장소의 지원 API 목록에 화학물질안전원 MSDS API가 포함되어 있습니다. 최신 지원 모듈 목록은 GitHub 저장소의 README를 직접 확인하세요.

공공 API 호출 횟수 제한이 있나요?

data.go.kr의 대부분 API는 일 1,000~10,000건의 기본 호출 한도를 제공합니다. 한도를 초과하면 추가 신청이 필요합니다. 구체적인 한도는 해당 API 상세 페이지의 ‘상세 정보’ 탭에서 확인하세요.

MSDS 데이터를 받아서 Claude가 실제로 무엇을 해줄 수 있나요?

화학물질 위험성 요약, 성분 분석, 복수 화학물질 비교 표 생성, 작업장 안전 교육 자료 초안 작성, MSDS 항목 기반 Q&A 응답 등을 자연어 대화로 처리할 수 있습니다. 연구자·안전 관리자·교육 담당자에게 특히 유용합니다.

다음 단계

화학물질 안전데이터 MCP 서버 설치가 완료됐다면, 이제 Claude와의 대화 속에서 MSDS 데이터를 자유롭게 활용할 수 있습니다. 더 많은 한국 공공데이터 MCP 서버를 탐색하고 싶다면 공공데이터 카테고리를 방문하거나, 전체 서버 목록에서 다른 도메인의 서버를 찾아보세요.

직접 개발한 화학물질 또는 공공데이터 MCP 서버가 있다면 서버 등록을 통해 한국 MCP 커뮤니티와 공유해 주세요.

이 글과 관련된 MCP 서버