Servidor MCP de atención médica

Un servidor de Protocolo de Contexto Modelo (MCP) que proporciona a los asistentes de IA acceso a datos de atención médica y herramientas de información médica.

Descripción general

El Servidor MCP de Salud es un servidor especializado que implementa el Protocolo de Contexto de Modelo (MCP) para proporcionar a los asistentes de IA acceso a datos de atención médica y herramientas de información médica. Permite a los modelos de IA recuperar información médica precisa y actualizada de fuentes confiables.

Características

Información sobre medicamentos de la FDA : Busque y recupere información completa sobre medicamentos de la base de datos de la FDA
PubMed Research : Busque literatura médica en la base de datos de artículos científicos de PubMed.
Temas de salud : Acceda a información de salud basada en evidencia en Health.gov
Ensayos clínicos : búsqueda de ensayos clínicos en curso y finalizados
Terminología médica : Busque códigos CIE-10 y definiciones de terminología médica
Almacenamiento en caché : sistema de almacenamiento en caché eficiente con agrupación de conexiones para reducir las llamadas a la API y mejorar el rendimiento
Seguimiento de uso : seguimiento de uso anónimo para supervisar el uso de la API
Manejo de errores : manejo y registro de errores robustos
Interfaces múltiples : compatibilidad con interfaces stdio (para CLI) y HTTP/SSE
Documentación de API : Documentación de API interactiva con Swagger UI
Pruebas integrales : Amplio conjunto de pruebas con pytest e informes de cobertura

Instalación

Instalación manual

Clonar el repositorio:
git clone https://github.com/Cicatriiz/healthcare-mcp-public.git cd healthcare-mcp-public
Crear un entorno virtual:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
Instalar dependencias:
pip install -r requirements.txt
Configurar variables de entorno (opcional):
# Create .env file from example cp .env.example .env # Edit .env with your API keys (optional)
Ejecutar el servidor:
python run.py

Uso

Corriendo en diferentes modos de transporte

Modo stdio (predeterminado, para Cline):
python run.py
Modo HTTP/SSE (para clientes web):
python run.py --http --port 8000

Probando las herramientas

Puede probar las herramientas MCP utilizando la nueva suite de pruebas basada en pytest:

# Run all tests with pytest and coverage
python -m tests.run_tests --pytest

# Run a specific test file
python -m tests.run_tests --test test_fda_tool.py

# Test the HTTP server
python -m tests.run_tests --server --port 8000

Para mantener la compatibilidad con versiones anteriores, aún puedes ejecutar las pruebas antiguas:

# Run all tests (old style)
python -m tests.run_tests

# Test individual tools (old style)
python -m tests.run_tests --fda        # Test FDA drug lookup
python -m tests.run_tests --pubmed     # Test PubMed search
python -m tests.run_tests --health     # Test Health Topics
python -m tests.run_tests --trials     # Test Clinical Trials search
python -m tests.run_tests --icd        # Test ICD-10 code lookup

Referencia de API

El servidor MCP de atención médica proporciona una API programática para integración directa y una API HTTP RESTful para clientes web.

Puntos finales de API RESTful

Cuando se ejecuta en modo HTTP, están disponibles los siguientes puntos finales:

Chequeo de salud

GET /health

Devuelve el estado del servidor y sus servicios.

Búsqueda de medicamentos de la FDA

GET /api/fda?drug_name={drug_name}&search_type={search_type}

Parámetros:

drug_name : Nombre del medicamento a buscar
search_type : Tipo de información a recuperar
- general : Información básica del medicamento (predeterminado)
- label : Información de etiquetado de medicamentos
- adverse_events : Eventos adversos notificados

Ejemplo de respuesta:

{
  "status": "success",
  "drug_name": "aspirin",
  "search_type": "general",
  "total_results": 25,
  "results": [
    {
      "brand_name": "ASPIRIN",
      "generic_name": "ASPIRIN",
      "manufacturer": "Bayer Healthcare",
      "product_type": "HUMAN OTC DRUG",
      "route": "ORAL",
      "active_ingredients": [
        {
          "name": "ASPIRIN",
          "strength": "325 mg/1"
        }
      ]
    }
  ]
}

Búsqueda en PubMed

GET /api/pubmed?query={query}&max_results={max_results}&date_range={date_range}

Parámetros:

query : Consulta de búsqueda de literatura médica
max_results : Número máximo de resultados a devolver (predeterminado: 5, máximo: 50)
date_range : Límite a artículos publicados en los últimos años (por ejemplo, '5' para los últimos 5 años)

Ejemplo de respuesta:

{
  "status": "success",
  "query": "diabetes treatment",
  "total_results": 123456,
  "date_range": "5",
  "articles": [
    {
      "pmid": "12345678",
      "title": "New advances in diabetes treatment",
      "authors": ["Smith J", "Johnson A"],
      "journal": "Journal of Diabetes Research",
      "publication_date": "2023-01-15",
      "abstract": "This study explores new treatment options...",
      "url": "https://pubmed.ncbi.nlm.nih.gov/12345678/"
    }
  ]
}

Temas de salud

GET /api/health_finder?topic={topic}&language={language}

Parámetros:

topic : Tema de salud para buscar información
language : Idioma del contenido (en o es, predeterminado: en)

Ejemplo de respuesta:

{
  "status": "success",
  "search_term": "diabetes",
  "language": "en",
  "total_results": 15,
  "topics": [
    {
      "title": "Diabetes Type 2",
      "url": "https://health.gov/myhealthfinder/topics/health-conditions/diabetes/diabetes-type-2",
      "last_updated": "2023-05-20",
      "section": "Health Conditions",
      "description": "Information about managing type 2 diabetes",
      "content": ["Diabetes is a disease...", "Treatment options include..."]
    }
  ]
}

Búsqueda de ensayos clínicos

GET /api/clinical_trials?condition={condition}&status={status}&max_results={max_results}

Parámetros:

condition : Condición médica o enfermedad a buscar
status : Estado de la prueba (en proceso de reclutamiento, completada, activa, no reclutando o todas)
max_results : Número máximo de resultados a devolver (predeterminado: 10, máximo: 100)

Ejemplo de respuesta:

{
  "status": "success",
  "condition": "breast cancer",
  "search_status": "recruiting",
  "total_results": 256,
  "trials": [
    {
      "nct_id": "NCT12345678",
      "title": "Study of New Treatment for Breast Cancer",
      "status": "Recruiting",
      "phase": "Phase 2",
      "study_type": "Interventional",
      "conditions": ["Breast Cancer", "HER2-positive Breast Cancer"],
      "locations": [
        {
          "facility": "Memorial Hospital",
          "city": "New York",
          "state": "NY",
          "country": "United States"
        }
      ],
      "sponsor": "National Cancer Institute",
      "url": "https://clinicaltrials.gov/study/NCT12345678",
      "eligibility": {
        "gender": "Female",
        "min_age": "18 Years",
        "max_age": "75 Years",
        "healthy_volunteers": "No"
      }
    }
  ]
}

Búsqueda de códigos CIE-10

GET /api/medical_terminology?code={code}&description={description}&max_results={max_results}

Parámetros:

code : código CIE-10 a buscar (opcional si se proporciona una descripción)
description : Descripción de la condición médica a buscar (opcional si se proporciona el código)
max_results : Número máximo de resultados a devolver (predeterminado: 10, máximo: 50)

Ejemplo de respuesta:

{
  "status": "success",
  "search_type": "description",
  "search_term": "diabetes",
  "total_results": 25,
  "codes": [
    {
      "code": "E11",
      "description": "Type 2 diabetes mellitus",
      "category": "Endocrine, nutritional and metabolic diseases"
    },
    {
      "code": "E10",
      "description": "Type 1 diabetes mellitus",
      "category": "Endocrine, nutritional and metabolic diseases"
    }
  ]
}

Ejecución de herramientas genéricas

POST /mcp/call-tool

Cuerpo de la solicitud:

{
  "name": "fda_drug_lookup",
  "arguments": {
    "drug_name": "aspirin",
    "search_type": "general"
  },
  "session_id": "optional-session-id"
}

API programática

Al utilizar el servidor MCP mediante programación, están disponibles las siguientes funciones:

Búsqueda de medicamentos de la FDA

fda_drug_lookup(drug_name: str, search_type: str = "general")

Parámetros:

drug_name : Nombre del medicamento a buscar
search_type : Tipo de información a recuperar
- general : Información básica del medicamento (predeterminado)
- label : Información de etiquetado de medicamentos
- adverse_events : Eventos adversos notificados

Búsqueda en PubMed

pubmed_search(query: str, max_results: int = 5, date_range: str = "")

Parámetros:

query : Consulta de búsqueda de literatura médica
max_results : Número máximo de resultados a devolver (predeterminado: 5)
date_range : Límite a artículos publicados en los últimos años (por ejemplo, '5' para los últimos 5 años)

Temas de salud

health_topics(topic: str, language: str = "en")

Parámetros:

topic : Tema de salud para buscar información
language : Idioma del contenido (en o es, predeterminado: en)

Búsqueda de ensayos clínicos

clinical_trials_search(condition: str, status: str = "recruiting", max_results: int = 10)

Parámetros:

condition : Condición médica o enfermedad a buscar
status : Estado de la prueba (en proceso de reclutamiento, completada, activa, no reclutando o todas)
max_results : Número máximo de resultados a devolver

Búsqueda de códigos CIE-10

lookup_icd_code(code: str = None, description: str = None, max_results: int = 10)

Parámetros:

code : código CIE-10 a buscar (opcional si se proporciona una descripción)
description : Descripción de la condición médica a buscar (opcional si se proporciona el código)
max_results : Número máximo de resultados a devolver

Fuentes de datos

Este servidor MCP utiliza varias API de atención médica disponibles públicamente:

Versión Premium (aún en desarrollo)

Esta es la versión gratuita de Healthcare MCP Server con límites de uso. Para funciones avanzadas y límites de uso más altos, consulte nuestra versión premium:

Llamadas API ilimitadas
Herramientas avanzadas de datos de atención médica
Integraciones personalizadas
Soporte prioritario

Licencia

Licencia MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto modelo que proporciona a los asistentes de IA acceso a herramientas de datos de atención médica, incluida información sobre medicamentos de la FDA, investigación de PubMed, temas de salud, ensayos clínicos y búsqueda de terminología médica.

Related MCP Servers

Senechal MCP Server
mattjoyce
-
security
A
license
-
quality
A Model Context Protocol server that provides health data from the Senechal API to LLM applications, enabling AI assistants to access, analyze, and respond to personal health information.
Last updated -
Python
GPL 3.0
PBS MCP AI Enabled API Server
matthewdcage
-
security
-
license
-
quality
A standalone Model Context Protocol server that enables AI models to access the Australian Pharmaceutical Benefits Scheme (PBS) API data, including medicine listings, pricing, and availability information.
Last updated -
1
JavaScript
MIT License
MedAdapt Content Server
ryoureddy
-
security
A
license
-
quality
A specialized Model Context Protocol server that enhances AI-assisted medical learning by connecting Claude Desktop to PubMed, NCBI Bookshelf, and user documents for searching, retrieving, and analyzing medical education content.
Last updated -
Python
MIT License
eRegulations MCP Server
unctad-ai
A
security
F
license
A
quality
A Model Context Protocol server implementation that provides structured, AI-friendly access to eRegulations data, making it easier for AI models to answer user questions about administrative procedures.
Last updated -
4
19
TypeScript

View all related MCP servers

Appeared in Searches

A database or source for finding medical information about esophageal cancer

Healthcare MCP Server