medical-mcp

Un servidor MCP que proporciona información médica completa consultando múltiples APIs médicas autorizadas, incluyendo FDA, WHO, PubMed, Google Scholar y RxNorm.

GitHub
108

Documentación

🩺 Servidor MCP Médico

Lleva datos médicos confiables directamente a tu flujo de trabajo de IA. Un servidor local para acceso privado y gratuito a FDA, OMS, PubMed, RxNorm y Google Scholar. Sin claves API. Sin fugas de datos.

Un servidor MCP (Model Context Protocol) que trae información médica autoritativa a entornos de codificación de IA como Cursor y Claude Desktop.

medical-mcp MCP server

Trust Score

¿Por qué usar Medical MCP?

  • 🔒 Tus datos nunca salen – Se ejecuta 100% localmente; sin seguimiento, sin registros, sin nube
  • 🆓 Sin claves API – Funciona de inmediato, cero configuración
  • 🏥 Fuentes autoritativas – FDA, OMS, PubMed, RxNorm, Google Scholar, AAP, revistas pediátricas
  • ⚡ Configuración fácil – Instalación con un clic en Cursor o configuración manual simple
  • 🔬 Integral – Información de medicamentos, estadísticas de salud, literatura médica, guías clínicas, fuentes pediátricas

Inicio rápido

¿Listo para llevar inteligencia médica a tu flujo de trabajo de IA? Instala en segundos:

Instalar en Cursor (Recomendado):

🔗 Instalar en Cursor

O instalar manualmente:

npm install -g medical-mcp
# Or from source:
git clone https://github.com/JamesANZ/medical-mcp.git
cd medical-mcp && npm install && npm run build

Características

💊 Información de medicamentos

  • search-drugs – Busca en la base de datos de la FDA por nombre de marca o genérico
  • get-drug-details – Obtén información completa del medicamento por código NDC
  • search-drug-nomenclature – Nombres estandarizados de medicamentos vía RxNorm

📊 Estadísticas de salud

  • get-health-statistics – Datos del Observatorio Global de Salud de la OMS (esperanza de vida, mortalidad, prevalencia de enfermedades)

🔬 Literatura médica

  • search-medical-literature – Busca más de 30 millones de artículos de PubMed
  • get-article-details – Información detallada del artículo por PMID
  • search-google-scholar – Investigación académica con citas
  • search-medical-databases – Búsqueda en múltiples bases de datos (PubMed, Scholar, Cochrane, ClinicalTrials.gov)
  • search-medical-journals – Revistas principales (NEJM, JAMA, Lancet, BMJ, Nature Medicine)

🏥 Herramientas clínicas

  • search-clinical-guidelines – Recomendaciones de práctica de organizaciones médicas

👶 Fuentes pediátricas

  • search-pediatric-guidelines – Guías de la AAP y atención preventiva Bright Futures
  • search-pediatric-literature – Investigación de revistas pediátricas principales (Pediatrics, JAMA Pediatrics, etc.)
  • get-child-health-statistics – Indicadores de salud pediátrica de la OMS (mortalidad, inmunización, nutrición)
  • search-pediatric-drugs – Medicamentos con etiquetado pediátrico e información de dosificación
  • search-aap-guidelines – Búsqueda integral de guías de la AAP (Bright Futures + Declaraciones de políticas)

📊 Gestión de caché

  • get-cache-stats – Ver estadísticas de caché (tasa de aciertos, uso de memoria, número de entradas)

Instalación

Cursor (un clic)

Haz clic en el enlace de instalación anterior o usa:

cursor://anysphere.cursor-deeplink/mcp/install?name=medical-mcp&config=eyJtZWRpY2FsLW1jcCI6eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1lZGljYWwtbWNwIl19fQ==

Instalación manual

Requisitos: Node.js 18+ y npm

# Clone and build
git clone https://github.com/JamesANZ/medical-mcp.git
cd medical-mcp
npm install
npm run build

# Run server
npm start

Claude Desktop

Agrega a claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "medical-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/medical-mcp/build/index.js"]
    }
  }
}

Reinicia Claude Desktop después de la configuración.

Ejemplos de uso

Buscar información de medicamentos

Pregunta sobre usos, dosis e información de seguridad de un medicamento:

{
  "tool": "search-drugs",
  "arguments": { "query": "Tylenol", "limit": 5 }
}

Obtener estadísticas de salud

Recupera indicadores de salud globales como esperanza de vida o tasas de mortalidad:

{
  "tool": "get-health-statistics",
  "arguments": {
    "indicator": "Life expectancy at birth (years)",
    "country": "USA"
  }
}

Buscar literatura médica

Encuentra artículos de investigación revisados por pares sobre cualquier tema médico:

{
  "tool": "search-medical-literature",
  "arguments": { "query": "COVID-19 treatment", "max_results": 10 }
}

Fuentes de datos

FuenteCoberturaFrecuencia de actualización
FDATodos los medicamentos aprobados por la FDA (EE. UU.)Tiempo real
OMSEstadísticas de salud globales (194 países)Anual
PubMedMás de 30 millones de citas médicasDiaria
RxNormNomenclatura estandarizada de medicamentos (EE. UU.)Semanal
Google ScholarArtículos académicos de todas las disciplinasTiempo real
AAPGuías Bright Futures y declaraciones de políticasPeriódica
Revistas pediátricasRevistas pediátricas principales (Pediatrics, JAMA Pediatrics, etc.)Diaria

Seguridad y privacidad

  • ✅ Solo localhost – El servidor se ejecuta localmente, sin acceso externo
  • ✅ Sin almacenamiento de datos – Todas las consultas son en tiempo real, nada se guarda
  • ✅ Aislamiento de procesos – Los datos médicos permanecen en tu máquina
  • ✅ Sin claves API – Sin credenciales que gestionar o filtrar

Casos de uso

  • Investigadores médicos – Revisiones rápidas de literatura sin muros de pago
  • Desarrolladores de salud – Construye prototipos con datos médicos reales
  • Estudiantes – Accede a información de medicamentos y artículos de investigación
  • Clínicos – Herramienta de referencia para detalles de medicamentos y estadísticas de salud
  • Pediatras – Guías de la AAP, Bright Futures, literatura pediátrica y datos de salud infantil

Caché

El servidor incluye una capa de caché en memoria para mejorar los tiempos de respuesta y reducir las llamadas a la API:

  • Caché automática: Todas las respuestas de la API se almacenan en caché con políticas TTL específicas por fuente
  • Políticas TTL:
    • Datos de la FDA: 24 horas
    • Artículos de PubMed: 1 hora
    • Estadísticas de la OMS: 7 días
    • Nomenclatura RxNorm: 30 días
    • Guías clínicas: 7 días
    • Google Scholar: 1 hora
    • Bright Futures: 30 días
    • Políticas de la AAP: 7 días
    • Revistas pediátricas: 1 hora
    • Indicadores de salud infantil: 7 días
    • Medicamentos pediátricos: 24 horas
  • Gestión de caché: Limpieza automática de entradas expiradas cada 5 minutos
  • Evicción LRU: Las entradas menos recientemente usadas se eliminan cuando la caché supera las 1000 entradas
  • Estadísticas de caché: Usa la herramienta get-cache-stats para ver tasas de aciertos y uso de memoria

Configuración (a través de variables de entorno):

  • CACHE_ENABLED=true - Habilitar/deshabilitar caché (predeterminado: true)
  • CACHE_MAX_SIZE=1000 - Número máximo de entradas de caché (predeterminado: 1000)
  • CACHE_TTL_FDA=86400 - TTL de la FDA en segundos (predeterminado: 86400)
  • CACHE_TTL_PUBMED=3600 - TTL de PubMed en segundos (predeterminado: 3600)
  • CACHE_TTL_WHO=604800 - TTL de la OMS en segundos (predeterminado: 604800)
  • CACHE_TTL_RXNORM=2592000 - TTL de RxNorm en segundos (predeterminado: 2592000)
  • CACHE_CLEANUP_INTERVAL=300000 - Intervalo de limpieza en milisegundos (predeterminado: 300000)

Rendimiento: Las respuestas en caché suelen devolverse en <10 ms frente a 800-1500 ms para llamadas a la API. Tasa de aciertos de caché esperada: 60%+ para consultas comunes.

Detalles técnicos

Construido con: Node.js, TypeScript, MCP SDK
Dependencias: @modelcontextprotocol/sdk, superagent, puppeteer, zod
Plataformas: macOS, Windows, Linux

Nota: El acceso a Google Scholar utiliza web scraping con limitación de velocidad. Otras fuentes usan APIs oficiales.

Aviso médico

⚠️ Importante: Esta herramienta proporciona información de fuentes autoritativas pero no debe reemplazar el consejo médico profesional, el diagnóstico o el tratamiento. Siempre consulta a profesionales de la salud calificados para decisiones médicas.

Contribuciones

⭐ Si este proyecto te ayuda, ¡dale una estrella en GitHub! ⭐

¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía un pull request.

Licencia

Licencia MIT – consulta LICENSE.md para más detalles.

Soporte

Si encuentras útil este proyecto, considera apoyarlo:

⚡ Red Lightning

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f