Medical: Common Disease Knowledge Search

This MCP service provides retrieval and detail query capabilities for common knowledge about diseases, vaccines, examinations, and treatments, suitable for health knowledge queries and auxiliary understanding of medical concepts.

Main Features

• 🩺 Knowledge of disease causes, symptoms, prevention, and treatment

• 💉 Vaccination targets, efficacy, contraindications, and precautions

• 🔬 Purpose, preparation, methods, and risks of medical examinations

• 💊 Applicable diseases, preparation, risks, and rehabilitation knowledge for treatments

• 🔗 Related diseases, hospitals, departments, examinations, and treatment information

Related MCP server: Medical MCP Server

Recommended Call Flow

1. Extract the keyword, resource category, and department from the user's question.

2. Call medical_resource_search to find candidate knowledge entries.

3. Obtain medicalInfoId and medicalType from the results.

4. Call medical_resource_detail to query the full knowledge content.

When querying details, both the ID and the correct resource category must be provided; do not construct the ID yourself based on the Chinese name.

Service Design Notes

• The service provides 2 read-only Tools, uniformly covering four categories of resources: diseases, vaccines, examinations, and treatments.

• Chinese categories are mapped to the Disease, Vaccine, Check, and Treatment values used by the Product API.

• All successful responses uniformly use the total/resultList top-level structure; when a detail is matched, total is usually 1.

• Content is for common knowledge queries only and does not replace doctor diagnosis, prescriptions, or emergency medical services.

Environment Requirements

• Python 3.10+

• Dependencies: mcp, python-dotenv, requests

Local Quick Start

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

Default service address: http://127.0.0.1:8000/mcp. Supports stdio, sse, and streamable-http.

Environment Variables

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

Available Tools and Product IDs

Tool Detailed Description

1. medical_resource_search

When to use: Use this when the user asks about a disease, vaccine, medical examination, or treatment; it is also the entry point for detail queries.

Key parameters:

• keyword: Resource name or content keyword, e.g., "influenza" or "hepatitis B vaccine".

• medicalType: Allowed values are "disease", "vaccine", "examination", "treatment".

• medicalDepartmentList: Department filter; multiple departments can be separated by commas.

• pageIndex: Starts at 1; pageSize defaults to 10, maximum 50.

Return description: Returns summaries such as resource name, category, aliases, department, and introduction, and provides medicalInfoId and medicalType for detail queries.

2. medical_resource_detail

When to use: Use this when the knowledge entry has been confirmed and you need to view the full content, such as disease causes, vaccine contraindications, examination preparation, or treatment risks.

Key parameters:

• medicalId: Required; use the medicalInfoId from the search results.

• medicalType: Required; must match the search results; supports disease/vaccine/examination/treatment and their corresponding English values.

Return description: Returns the complete knowledge fields for the corresponding category, as well as related diseases, hospitals, examinations, or treatment information.

Usage Examples

Example 1: Query Disease Knowledge

User question:

Search for disease knowledge related to influenza, show 5 results first.

Suggested call:

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

Example 2: Query Disease Details

User question:

View the causes, symptoms, prevention, and treatment methods of the disease just mentioned.

Suggested call:

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

Example 3: Query Vaccine Knowledge

User question:

Query the vaccination targets, contraindications, and precautions for the hepatitis B vaccine.

First call medical_resource_search and set medicalType="vaccine"; after confirming the entry, call the detail Tool.

Usage Notes

1. medicalId and medicalType must come from the same search result.

2. If the search term is too broad, prioritize adding medicalType or department conditions.

3. The returned content is knowledge material and is not used for automated diagnosis or as a substitute for professional medical advice.

Testing and Verification

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

Unit tests use Mock responses; real verification is done by calling the HandaaS Integrator Gateway through the local .env.