医療：疾病の一般知識検索

この MCP サービスは、疾病・ワクチン・検査・治療の一般知識の検索・詳細照会機能を提供し、健康知識の照会や医療概念の補助的理解に適しています。

主な機能

• 🩺 疾病の病因・症状・予防・治療知識

• 💉 ワクチンの接種対象・効果・禁忌・注意事項

• 🔬 医療検査の目的・準備・方法・リスク

• 💊 治療の対象疾患・準備・リスク・リハビリ知識

• 🔗 関連する疾病・病院・診療科・検査・治療情報

Related MCP server: Medical MCP Server

推奨呼び出しフロー

1. ユーザーの質問に基づき、資料キーワード、資料分類、受診診療科を抽出する。

2. medical_resource_search を呼び出し、候補となる知識項目を検索する。

3. 結果から medicalInfoId と medicalType を取得する。

4. medical_resource_detail を呼び出し、完全な知識内容を照会する。

詳細照会時は、ID と正しい資料分類を同時に渡す必要があります。中国語名に基づいて ID を独自に構築しないでください。

サービス設計の説明

• 本サービスは読み取り専用の Tool を 2 つ提供し、疾病・ワクチン・検査・治療の4種類の資料を統一的にカバーします。

• 中国語の分類は 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：資料名または内容のキーワード。例：「流感」「乙肝疫苗」。

• 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：ワクチン知識の検索

ユーザーの質問：

乙肝疫苗の接種対象、禁忌、注意事項を調べて。

先に medical_resource_search を呼び出し、medicalType="疫苗" を設定します。その後、結果のうち適切な項目で medicalType を「疫苗」または Vaccine に設定して medical_resource_detail を呼び出します。

使用上の注意事項

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 を呼び出して行います。