기본 요소

이름

설명

도구

search_doctors

이름이나 전문 분야별로 의사 검색

도구

get_available_slots

특정 날짜의 의사 예약 가능 시간대 조회

도구

book_appointment

진료 예약 (확인을 위해 유도(elicitation) 사용)

도구

cancel_appointment

진료 예약 취소 (확인을 위해 유도(elicitation) 사용)

도구

list_appointments

필터를 사용하여 예약 목록 조회

도구

recommend_specialist

증상 기반 전문의 추천 (샘플링 사용)

리소스

specialties://list

모든 의료 전문 분야의 정적 목록

리소스

doctor://{doctorId}/profile

템플릿을 포함한 동적 의사 프로필

리소스

patient://{patientId}/summary

환자 정보 + 예약 내역

리소스

appointment://{appointmentId}

전체 예약 상세 정보

프롬프트

schedule-appointment

안내형 진료 예약 워크플로우 (완성(completion) 포함)

프롬프트

patient-history

환자 진료 기록 검토 (완성(completion) 포함)

프롬프트

triage-symptoms

증상 분류 및 전문의 추천

기능

사용 방법

유도(Elicitation)

book_appointment 및 cancel_appointment는 진행 전 사용자에게 확인을 요청함

샘플링

recommend_specialist는 LLM 샘플링을 사용하여 증상과 전문 분야를 매칭함

루트(Roots)

서버가 의료 예약 워크스페이스를 위한 루트를 등록함

완성(Completion)

프롬프트는 completable()을 사용하여 전문 분야 이름과 환자 ID를 자동 완성함

스킬 워크플로우

대응하는 MCP 기본 요소

의사 찾기

search_doctors 도구

예약 가능 시간 확인

get_available_slots 도구

진료 예약

book_appointment 도구

예약 취소

cancel_appointment 도구

예약 목록 조회

list_appointments 도구

전문의 추천

recommend_specialist 도구

진료 예약

schedule-appointment 프롬프트

환자 진료 기록

patient-history 프롬프트

증상 분류

triage-symptoms 프롬프트

MCP 기능

제한 사항

유도(Elicitation)

book_appointment 및 cancel_appointment는 MCP 서버에서 기본 UI 확인 대화 상자를 사용합니다. 스킬에는 대응하는 기능이 없으며, 에이전트가 대화를 통해 확인을 요청합니다.

샘플링

recommend_specialist는 증상과 전문 분야를 매칭하기 위해 MCP 샘플링을 통해 하위 LLM을 호출합니다. 스킬은 에이전트 자신의 추론을 직접 사용합니다(기능적으로 동일).

인자 완성

MCP 프롬프트는 클라이언트 UI에서 전문 분야 이름과 환자 ID를 자동 제안하기 위해 completable()을 사용합니다. 스킬은 대화형 완성을 제공하지 않습니다.

루트(Roots)

MCP 서버는 워크스페이스 루트(roots/list)를 등록합니다. 이는 스킬 대응 기능이 없는 MCP 전송 개념입니다.

VS Code 전용 스킬 필드

argument-hint, user-invocable, disable-model-invocation과 같은 필드는 SKILL.md 형식에 대한 VS Code Copilot 확장입니다. 이는 agentskills.io 사양의 일부가 아니며 스킬의 이식성을 유지하기 위해 생략되었습니다.

메서드

엔드포인트

설명

GET

/api/specialties

모든 전문 분야 목록

GET

/api/specialties/:id

ID별 전문 분야 조회

GET

/api/doctors

의사 목록 (필터: ?specialtyId=, ?name=)

GET

/api/doctors/:id

ID별 의사 조회

GET

/api/doctors/:id/slots?date=YYYY-MM-DD

예약 가능한 시간대 조회

GET

/api/patients

모든 환자 목록

GET

/api/patients/:id

ID별 환자 조회

POST

/api/patients

환자 생성

GET

/api/appointments

예약 목록 (필터: ?patientId=, ?doctorId=, ?status=, ?date=)

GET

/api/appointments/:id

ID별 예약 조회

POST

/api/appointments

진료 예약

PATCH

/api/appointments/:id/cancel

진료 예약 취소

PATCH

/api/appointments/:id/complete

진료 예약 완료

명령어

설명

npm run dev:service

핫 리로드가 포함된 Hono REST API 시작

npm run dev:mcp

stdio 모드에서 MCP 서버 시작

npm run build

TypeScript를 dist/로 컴파일

npm run typecheck

파일을 생성하지 않고 타입 체크

엔티티

설명

Specialty

의료 전문 분야 (심장내과, 피부과 등)

Doctor

전문 분야, 근무 가능 요일, 근무 시간, 시간대 지속 시간을 가짐

Patient

이름, 이메일, 전화번호, 생년월일

Appointment

환자와 의사를 특정 날짜/시간에 사유 및 상태와 함께 연결

TimeSlot

특정 날짜에 의사가 예약 가능하거나 예약된 시간 창