Sanidad: Búsqueda de información hospitalaria

Este servicio MCP ofrece capacidades de búsqueda de hospitales y consulta de detalles hospitalarios, ayudando a los usuarios a descubrir centros médicos y verificar las sedes, los departamentos, los datos de contacto, la presentación del hospital y la entidad operadora.

Funciones principales

• 🏥 Búsqueda difusa por nombre de hospital

• 🏷️ Filtrado por naturaleza, nivel y tipo especializado del hospital

• 📍 Consulta de provincia, ciudad y dirección de la sede

• 📞 Consulta de datos de contacto y departamentos del hospital

• 🧾 Presentación detallada del hospital y verificación de la entidad operadora

Related MCP server: Clinical Trials MCP Server

Flujo de llamada recomendado

1. Cuando el usuario solo proporcione el nombre del hospital, la región o el nivel, llame primero a medical_hospital_search.

2. Confirme el hospital entre los resultados candidatos y obtenga el hospitalId.

3. Llame a medical_hospital_detail para consultar las sedes, los datos de contacto, los departamentos y la presentación completa de ese hospital.

No utilice el nombre del hospital en lugar de hospitalId para llamar a la herramienta de detalles, ni construya el ID del hospital por su cuenta.

Notas de diseño del servicio

• El servicio solo ofrece 2 herramientas de solo lectura relacionadas con la información hospitalaria.

• Todas las respuestas exitosas utilizan de forma uniforme el nivel superior total/resultList; cuando se encuentra un detalle, normalmente total=1.

• El código de negocio 10001 查询数据为空 se normaliza como total=0, resultList=[] y no se trata como un error del sistema.

• La herramienta no ofrece capacidades de cita médica en línea, recomendaciones de diagnóstico y tratamiento, reservas, pagos ni escritura.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

cd medical-hospital-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

La dirección predeterminada del servicio es http://127.0.0.1:8000/mcp. Admite 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 producto

Descripción detallada de las herramientas

1. medical_hospital_search

Cuándo usarla: se utiliza cuando el usuario pregunta por un hospital concreto, los hospitales de una región, los hospitales de un nivel o un tipo de hospital especializado; también es la puerta de entrada para la consulta de detalles.

Parámetros clave:

• hospitalName: palabra clave del nombre del hospital, admite búsqueda difusa, por ejemplo, "协和".

• hospitalType: naturaleza del hospital, por ejemplo, "pública" o "privada".

• hospitalLevel: nivel del hospital, por ejemplo, "3A", "2A", "nivel 3".

• hospitalProfessionalType: tipo especializado, por ejemplo, "hospital general", "hospital infantil".

• hospitalProvince: valor de filtro de la provincia, utilice nombres cortos como "Beijing" o "Guangdong", sin el sufijo de provincia ni de ciudad.

• pageIndex: comienza en 1; pageSize tiene un valor predeterminado de 10 y un máximo de 50.

Descripción de la respuesta: devuelve un resumen con el nombre del hospital, el nivel, la naturaleza, el tipo especializado, la región, las sedes, los departamentos y la entidad operadora. Para la consulta de detalles posterior, utilice el hospitalId del resultado.

2. medical_hospital_detail

Cuándo usarla: se utiliza cuando ya se ha confirmado el hospital mediante la búsqueda y se necesita consultar las sedes completas, los datos de contacto, los departamentos o la presentación del hospital.

Parámetros clave:

• hospitalId: obligatorio, debe proceder del resultado de medical_hospital_search.

Descripción de la respuesta: cuando hay coincidencia, devuelve un único detalle del hospital, que incluye la dirección de la sede, el teléfono de contacto, los departamentos, la presentación detallada y la entidad operadora.

Ejemplos de uso

Ejemplo 1: Búsqueda de hospital

Pregunta del usuario:

Busque hospitales generales de nivel 3A en Beijing y devuelva primero 5 resultados.

Llamada sugerida:

{
  "tool": "medical_hospital_search",
  "arguments": {
    "hospitalLevel": "三甲",
    "hospitalProfessionalType": "综合医院",
    "hospitalProvince": "北京",
    "pageIndex": 1,
    "pageSize": 5
  }
}

Ejemplo 2: Consulta de detalles del hospital

Pregunta del usuario:

Consulte la dirección de la sede, el teléfono de contacto y los departamentos del hospital que acabo de confirmar.

Llamada sugerida:

{
  "tool": "medical_hospital_detail",
  "arguments": {
    "hospitalId": "从医院搜索结果取得"
  }
}

Precauciones de uso

1. Los resultados de búsqueda pueden incluir hospitales diferentes con nombres similares; primero debe verificar la región y el nivel del hospital.

2. El hospitalId solo puede proceder de los resultados de búsqueda de hospitales.

3. Un resultado vacío es un resultado de negocio válido; puede reducir los criterios de filtrado y volver a buscar.

Verificación de pruebas

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

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