의료: 질병 상식 검색

이 MCP 서비스는 질병, 백신, 검사 및 치료 상식의 검색과 상세 조회 기능을 제공하며, 건강 지식 조회 및 의료 개념 보조 이해에 적합합니다.

주요 기능

• 🩺 질병 원인, 증상, 예방 및 치료 지식

• 💉 백신 접종 대상, 효능, 금기 및 주의사항

• 🔬 의료 검사 목적, 준비, 방법 및 위험

• 💊 치료 적용 질병, 준비, 위험 및 재활 지식

• 🔗 관련 질병, 병원, 진료과, 검사 및 치료 정보

Related MCP server: Medical MCP Server

권장 호출 흐름

1. 사용자 질문에서 자료 키워드, 자료 분류 및 진료과를 추출합니다.

2. medical_resource_search를 호출하여 후보 지식 항목을 검색합니다.

3. 결과에서 medicalInfoId와 medicalType을 가져옵니다.

4. medical_resource_detail을 호출하여 전체 지식 내용을 조회합니다.

상세 조회 시 ID와 올바른 자료 분류를 동시에 전달해야 합니다. 한글 이름을 기준으로 ID를 직접 구성하지 마십시오.

서비스 설계 설명

• 서비스는 2개의 읽기 전용 Tool을 제공하며, 질병, 백신, 검사 및 치료 네 가지 자료를 통합적으로 다룹니다.

• 한글 분류는 Product API에서 사용하는 Disease, Vaccine, Check, Treatment로 매핑됩니다.

• 모든 성공 응답은 통일된 total/resultList 최상위 구조를 사용합니다. 상세 조회 시 일반적으로 total=1입니다.

• 내용은 일반 상식 조회에만 사용되며, 의사의 진단, 처방 또는 응급 의료 서비스를 대체하지 않습니다.

환경 요구사항

• Python 3.10+

• 의존성: mcp, python-dotenv, requests

로컬 빠른 시작

cd medical-knowledge-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

서비스 기본 주소: http://127.0.0.1:8000/mcp. stdio, sse 및 streamable-http를 지원합니다.

환경 변수

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

사용 가능한 Tool 및 Product ID

Tool 상세 설명

1. medical_resource_search

사용 시점: 사용자가 특정 질병, 백신, 의료 검사 또는 치료 방법을 문의할 때 사용하며, 상세 조회의 진입점이기도 합니다.

주요 파라미터:

• keyword: 자료 이름 또는 내용 키워드, 예: "독감", "B형 간염 백신".

• medicalType: 선택 값은 "질병", "백신", "검사", "치료"입니다.

• medicalDepartmentList: 진료과 필터 값, 다단계 진료과는 쉼표로 구분할 수 있습니다.

• pageIndex: 1부터 시작합니다. pageSize는 기본 10, 최대 50입니다.

반환 설명: 자료 이름, 분류, 별칭, 진료과 및 요약 등의 정보를 반환하며, 상세 조회용 medicalInfoId와 medicalType을 제공합니다.

2. medical_resource_detail

사용 시점: 지식 항목이 확인되었고, 질병 원인·증상, 백신 금기, 검사 준비 또는 치료 위험 등의 전체 내용을 확인해야 할 때 사용합니다.

주요 파라미터:

• medicalId: 필수, 검색 결과의 medicalInfoId를 사용합니다.

• medicalType: 필수, 검색 결과와 일치해야 합니다. 질병/백신/검사/치료 및 해당 영문 값을 지원합니다.

반환 설명: 분류별로 해당하는 전체 지식 필드와 관련 질병, 병원, 검사 또는 치료 정보를 반환합니다.

사용 예시

예시 1: 질병 지식 조회

사용자 질문:

독감 관련 질병 지식을 검색해서 먼저 5개를 보여주세요.

권장 호출:

{
  "tool": "medical_resource_search",
  "arguments": {
    "keyword": "流感",
    "medicalType": "疾病",
    "pageIndex": 1,
    "pageSize": 5
  }
}

예시 2: 질병 상세 조회

사용자 질문:

방금 질병의 원인, 증상, 예방 및 치료 방법을 확인해 주세요.

권장 호출:

{
  "tool": "medical_resource_detail",
  "arguments": {
    "medicalId": "从知识搜索结果取得",
    "medicalType": "疾病"
  }
}

예시 3: 백신 지식 조회

사용자 질문:

B형 간염 백신의 접종 대상, 금기 및 주의사항을 조회해 주세요.

먼저 medical_resource_search를 호출하고 medicalType="백신"으로 설정한 후, 항목을 확인한 다음 상세 Tool을 호출합니다.

사용 주의사항

1. medicalId와 medicalType은 반드시 동일한 검색 결과에서 가져와야 합니다.

2. 검색어가 너무 광범위할 경우 medicalType 또는 진료과 조건을 우선 추가합니다.

3. 반환 내용은 지식 자료이므로 자동 진단이나 전문 의료 의견 대체에 사용하지 않습니다.

테스트 검증

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

단위 테스트는 Mock 응답을 사용합니다. 실제 검증은 로컬 .env를 통해 HandaaS Integrator Gateway를 호출하여 수행합니다.