M MCP모아
튜토리얼

응급실 현황 MCP 서버 — 공공 의료 API를 Claude에 연결해 실시간 조회

공공데이터포털 응급실 현황 API를 MCP 서버로 연결해 Claude에서 실시간 병상 정보를 조회하는 방법을 단계별로 설명합니다. API 키 발급부터 Claude Desktop 설정까지 완전 가이드.

공공데이터포털 응급실 현황 API와 Claude가 MCP 서버를 통해 연결되는 구조를 보여주는 표지 이미지

공공데이터포털(data.go.kr)의 응급의료 현황 API를 MCP 서버로 연결하면 Claude에서 자연어로 전국 응급실 병상 현황을 실시간 조회할 수 있습니다. 이 가이드는 API 키 발급부터 Claude Desktop 연동, 동작 확인까지 전 과정을 단계별로 안내합니다. 별도 백엔드 개발 없이 MCP 프로토콜 하나로 공공 의료 데이터를 AI 워크플로우에 바로 통합할 수 있습니다.

왜 응급실 데이터를 AI에 연결해야 할까요?

응급실 현황은 시간이 촉박한 상황에서 가장 빠르게 접근해야 하는 정보 중 하나입니다. 보건복지부 중앙응급의료센터(NEMC)는 전국 응급의료기관의 가용 병상 수, 진료 가능 여부, 위치 정보를 API로 공개하고 있지만, 포털 웹사이트를 직접 방문하거나 API를 수동으로 호출하는 방식은 번거롭습니다.

MCP(Model Context Protocol) 서버를 통해 이 API를 Claude에 연결하면 다음과 같은 작업이 가능해집니다.

  • 자연어로 “지금 서울 서초구에서 소아과 진료 가능한 응급실이 어디야?”처럼 질의
  • 여러 병원 데이터를 자동으로 비교·요약
  • 다른 공공 API(교통 정보, 약국 현황 등)와 결합해 복합 시나리오 분석

데이터 흐름 구조

[Claude Desktop / Claude Code]
          |
          | MCP 프로토콜 (stdio / SSE)
          v
   [응급실 현황 MCP 서버]
          |
          | HTTPS REST API 호출
          v
[data.go.kr 응급의료 현황 API]
   (보건복지부 공공데이터)

클라이언트(Claude)가 자연어 질의를 보내면 MCP 서버가 이를 API 파라미터로 변환해 공공데이터포털에 요청하고, 응답 JSON을 Claude가 이해할 수 있는 형태로 반환합니다.

준비물

항목설명
공공데이터포털 계정data.go.kr 회원가입 (무료)
응급의료 현황 API 인증키포털에서 신청 후 발급
Node.js 18+ 또는 Python 3.10+MCP 서버 실행 환경
Claude Desktop 또는 Claude CodeMCP 클라이언트
Git저장소 클론용

단계별 설치 및 설정

1단계 — 공공데이터포털 API 키 발급

먼저 data.go.kr에 접속해 로그인합니다. 검색창에 “응급의료기관 현황” 또는 “응급실 실시간” 을 검색하면 보건복지부에서 제공하는 API 목록을 확인할 수 있습니다.

원하는 API 상세 페이지에서 활용신청 버튼을 클릭합니다. 활용 목적을 간단히 기재하면 즉시 또는 1~2 영업일 내에 일반 인증키(서비스 키) 가 마이페이지에 발급됩니다.

발급된 인증키를 안전한 곳에 복사해 두세요. 이후 단계에서 환경 변수로 사용합니다.

2단계 — MCP 서버 저장소 클론

현재 응급실 현황 API를 단독으로 래핑하는 공개 MCP 패키지는 알려져 있지 않습니다. 가장 빠른 방법은 한국 공공데이터포털 API를 묶어서 제공하는 공공데이터포털 MCP 서버 모음(data-go-mcp-servers)을 활용하거나, 직접 간단한 MCP 서버를 구현하는 것입니다.

직접 구현하는 경우, MCP 공식 SDK를 사용하면 수십 줄의 코드로 REST API를 MCP 도구로 노출할 수 있습니다.

# Node.js 기반 MCP 서버 프로젝트 초기화 예시
mkdir emergency-mcp && cd emergency-mcp
npm init -y
npm install @modelcontextprotocol/sdk node-fetch

3단계 — 환경 변수 설정

발급받은 API 키를 환경 변수로 등록합니다. 프로젝트 루트에 .env 파일을 만들어 관리하는 것을 권장합니다.

# .env 파일 예시
DATA_GO_KR_API_KEY=여기에_발급받은_인증키_입력

셸 환경에 직접 설정하려면 아래 명령을 사용합니다.

export DATA_GO_KR_API_KEY="여기에_발급받은_인증키_입력"

API 키를 소스 코드나 Git 저장소에 직접 포함하지 않도록 주의하세요. .gitignore에 .env를 추가해 두는 것이 좋습니다.

4단계 — Claude Desktop 설정 파일 수정

Claude Desktop의 MCP 설정 파일 위치는 운영체제에 따라 다릅니다.

운영체제설정 파일 경로
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

파일을 텍스트 에디터로 열고 mcpServers 항목에 서버 정보를 추가합니다. 아래는 Node.js로 구현한 서버를 등록하는 예시입니다.

{
  "mcpServers": {
    "emergency-room": {
      "command": "node",
      "args": ["/절대경로/emergency-mcp/index.js"],
      "env": {
        "DATA_GO_KR_API_KEY": "여기에_발급받은_인증키_입력"
      }
    }
  }
}

args의 경로는 반드시 절대 경로로 입력해야 합니다. 상대 경로를 사용하면 Claude Desktop이 서버를 찾지 못할 수 있습니다.

공공데이터포털 MCP 서버 모음을 uvx로 사용하는 경우에는 공식 저장소(github.com/Koomook/data-go-mcp-servers)의 README를 참조해 해당 서버의 설치 명령을 확인하세요.

5단계 — Claude Desktop 재시작 및 테스트

설정 파일 저장 후 Claude Desktop을 완전히 종료하고 다시 실행합니다. 앱이 시작될 때 mcpServers에 등록된 서버를 자동으로 기동합니다.

채팅창 하단의 도구 아이콘(망치 모양)에 등록된 도구가 나타나면 연결에 성공한 것입니다. 다음과 같은 질문으로 동작을 확인하세요.

현재 서울 지역 응급실 병상 현황을 알려줘.

Claude가 MCP 서버를 통해 API를 호출하고 결과를 정리해 답변하면 연동이 완료된 것입니다.

흔한 오류와 해결 방법

오류 상황원인해결 방법
도구가 목록에 나타나지 않음JSON 문법 오류 또는 경로 오탈자설정 파일을 JSON 검사기로 확인, 경로 절대값으로 재입력
API 호출 실패(401 Unauthorized)인증키 미설정 또는 오탈자환경 변수 이름·값을 다시 확인
API 호출 실패(429 Too Many Requests)일일 호출 한도 초과다음 날 재시도 또는 한도 상향 신청(포털에서 가능)
서버가 즉시 종료됨의존 패키지 미설치npm install 재실행, 오류 로그 확인
응답 데이터가 빈 값API 파라미터 오류공공데이터포털 API 명세서에서 필수 파라미터 확인

오류 발생 시 터미널에서 서버 명령을 직접 실행하면 스택 트레이스를 확인할 수 있어 원인 파악이 빠릅니다.

# 직접 실행해 오류 확인
node /절대경로/emergency-mcp/index.js

관련 공공 데이터 MCP 서버

응급실 현황 외에도 한국 공공데이터를 AI에 연결하는 MCP 서버들이 있습니다.

공공데이터 카테고리의 더 많은 서버는 /category/public-data에서 확인하세요. 전체 MCP 서버 목록은 서버 디렉토리에서 탐색하실 수 있습니다.

자주 묻는 질문

API 키 발급에 얼마나 걸리나요?

공공데이터포털(data.go.kr) 응급의료 현황 API는 신청 즉시 또는 1~2 영업일 안에 인증키가 발급됩니다. 일부 API는 담당 기관의 승인 절차가 필요해 최대 3영업일이 소요될 수 있습니다.

응급실 MCP 서버가 공식 패키지로 배포되어 있나요?

현재 응급실 현황 API만 단독으로 제공하는 공식 npm·PyPI 패키지는 알려져 있지 않습니다. 공공데이터포털 MCP 서버 모음처럼 여러 API를 묶은 프로젝트를 활용하거나, MCP 공식 SDK로 직접 구현하는 방법을 권장합니다.

응급실 현황 API는 실시간 데이터인가요?

보건복지부가 제공하는 응급의료 현황 API는 전국 응급의료기관의 병상 가용 정보를 주기적으로 갱신합니다. 갱신 주기는 기관마다 다를 수 있으며, API 명세서에서 정확한 업데이트 간격을 확인하시기 바랍니다.

Claude Code와 Claude Desktop 중 어디에 설정해야 하나요?

두 클라이언트 모두 MCP를 지원합니다. Claude Desktop은 claude_desktop_config.json을 수정해 등록하고, Claude Code는 프로젝트 루트의 .mcp.json 또는 설정 커맨드로 등록합니다. 개인 탐색·조회 목적이라면 Claude Desktop이, 개발 워크플로우 통합이라면 Claude Code가 더 편리합니다.

API 호출 비용이 발생하나요?

공공데이터포털의 응급의료 현황 API는 무료로 제공됩니다. 다만 일별 호출 횟수 제한이 있을 수 있으므로 API 상세 페이지에서 트래픽 정책을 반드시 확인하세요.

MCP 서버 설정 후 Claude가 도구를 인식하지 못하면 어떻게 해야 하나요?

claude_desktop_config.json의 JSON 문법 오류, 명령어 경로 오탈자, API 키 누락이 가장 흔한 원인입니다. 터미널에서 서버 명령을 직접 실행해 오류 메시지를 확인하고, Claude Desktop을 완전히 종료 후 재시작하세요.

다음 단계

응급실 현황 MCP 연동에 성공했다면 다른 공공 의료 데이터 API로 확장해 보세요. 약국 현황, 의료기관 정보, 응급의료통계 등 다양한 데이터를 동일한 방식으로 MCP 서버에 추가할 수 있습니다.

직접 구현한 MCP 서버가 있다면 MCP모아에 등록해 한국 개발자 커뮤니티와 공유해 주세요. 더 많은 공공데이터 활용 MCP 서버는 가이드 목록에서 확인하실 수 있습니다.

이 글과 관련된 MCP 서버