Médico: Búsqueda de conocimientos comunes sobre enfermedades

Este servicio MCP ofrece capacidades de búsqueda y consulta de conocimientos comunes sobre enfermedades, vacunas, exámenes y tratamientos, adecuado para consultas de conocimientos de salud y comprensión auxiliar de conceptos médicos.

Funciones principales

• 🩺 Conocimientos sobre causas, síntomas, prevención y tratamiento de enfermedades

• 💉 Objetivos de vacunación, eficacia, contraindicaciones y precauciones

• 🔬 Propósito, preparación, métodos y riesgos de los exámenes médicos

• 💊 Conocimientos sobre enfermedades aplicables al tratamiento, preparación, riesgos y rehabilitación

• 🔗 Información relacionada sobre enfermedades, hospitales, departamentos, exámenes y tratamientos

Related MCP server: Medical MCP Server

Flujo de llamada recomendado

1. Extraer palabras clave del material, categoría del material y departamento de consulta según la pregunta del usuario.

2. Llamar a medical_resource_search para buscar entradas de conocimiento candidatas.

3. Obtener medicalInfoId y medicalType de los resultados.

4. Llamar a medical_resource_detail para consultar el contenido completo del conocimiento.

Al consultar los detalles, se deben proporcionar simultáneamente el ID y la categoría correcta del material; no construir el ID manualmente según el nombre en chino.

Notas de diseño del servicio

• El servicio ofrece 2 herramientas de solo lectura, que cubren de manera unificada los cuatro tipos de materiales: enfermedades, vacunas, exámenes y tratamientos.

• Las categorías en chino se asignan a Disease, Vaccine, Check, Treatment utilizados por la API de Product.

• Todas las respuestas exitosas utilizan de forma unificada la estructura superior total/resultList; cuando se encuentra un detalle, normalmente total=1.

• El contenido se utiliza únicamente para consultas de conocimiento común y no sustituye el diagnóstico médico, la prescripción o los servicios médicos de emergencia.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

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

Dirección predeterminada del servicio: http://127.0.0.1:8000/mcp. Compatible con stdio, sse y streamable-http.

Variables de entorno

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

Herramientas disponibles e ID de Product

Descripción detallada de las herramientas

1. medical_resource_search

Cuándo usarla: cuando el usuario pregunta sobre una enfermedad, vacuna, examen médico o método de tratamiento, y también es la puerta de entrada para la consulta de detalles.

Parámetros clave:

• keyword: nombre del material o palabra clave del contenido, por ejemplo, "gripe" o "vacuna contra la hepatitis B".

• medicalType: valores opcionales: "enfermedad", "vacuna", "examen", "tratamiento".

• medicalDepartmentList: valor de filtro del departamento de consulta; los departamentos de varios niveles se pueden separar con comas.

• pageIndex: comienza en 1; pageSize es 10 por defecto, máximo 50.

Descripción de la respuesta: devuelve el nombre del material, la categoría, los alias, el departamento y un resumen, y proporciona medicalInfoId y medicalType para la consulta de detalles.

2. medical_resource_detail

Cuándo usarla: cuando ya se ha confirmado la entrada de conocimiento y se necesita ver el contenido completo, como las causas y síntomas de la enfermedad, las contraindicaciones de la vacuna, la preparación del examen o los riesgos del tratamiento.

Parámetros clave:

• medicalId: obligatorio, usar el medicalInfoId de los resultados de búsqueda.

• medicalType: obligatorio, debe coincidir con el resultado de búsqueda; admite enfermedad/vacuna/examen/tratamiento y sus valores en inglés correspondientes.

Descripción de la salida: cada categoría devuelve los campos de conocimiento completos correspondientes, así como información sobre enfermedades, hospitales, exámenes o tratamientos relacionados.

Ejemplos de uso

Ejemplo 1: Consultar conocimientos sobre enfermedades

Pregunta del usuario:

Busca conocimientos sobre la gripe, primero mira 5 resultados.

Llamada sugerida:

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

Ejemplo 2: Consultar detalles de la enfermedad

Pregunta del usuario:

Ver las causas, síntomas, prevención y métodos de tratamiento de la enfermedad anterior.

Llamada sugerida:

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

Ejemplo 3: Consultar conocimientos sobre vacunas

Pregunta del usuario:

Consulta los objetivos de vacunación, contraindicaciones y precauciones de la vacuna contra la hepatitis B.

Primero llama a medical_resource_search y establece medicalType="疫苗", confirma la entrada y luego llama a la herramienta de detalles.

Notas de uso

1. medicalId y medicalType deben provenir del mismo resultado de búsqueda.

2. Si el término de búsqueda es demasiado amplio, se debe priorizar agregar la condición medicalType o el departamento.

3. El contenido devuelto es material de conocimiento, no se utiliza para diagnóstico automático ni sustituye la opinión médica profesional.

Verificación de pruebas

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

Las pruebas unitarias utilizan respuestas simuladas; la verificación real se realiza mediante la llamada a HandaaS Integrator Gateway a través del .env local.