med-lit-mcp

Es un servidor MCP para reducir el tiempo que los profesionales sanitarios dedican a «buscar información». Permite consultar PubMed, ensayos clínicos, información farmacéutica, guías de práctica clínica y el máster de tarifas de asistencia sanitaria directamente desde Claude.

Según estudios estadounidenses, los médicos dedican entre 1,5 y 2 horas a tareas administrativas y de documentación por cada hora de consulta. Parte de ese tiempo se emplea en consultar bibliografía, prospectos y normativa. Este servidor apunta precisamente a eso.

Lo que este servidor no hace

Este software no es un programa de dispositivo médico (SaMD). La clasificación según la Ley de Productos Farmacéuticos y Dispositivos Médicos se determina por el «grado de contribución (impacto en el juicio médico)» y el «riesgo (daño en caso de mal funcionamiento)». Este servidor solo indica la ubicación de las fuentes primarias y no realiza juicios médicos, por lo que se mantiene dentro del ámbito de no aplicabilidad.

Por diseño, no hace lo siguiente:

• Presentar diagnósticos ni enumerar diagnósticos diferenciales

• Recomendar estrategias de tratamiento, selección de fármacos o dosis

• Interpretar hallazgos a partir de valores de laboratorio o imágenes

• Resumir o parafrasear resúmenes o prospectos (se devuelve el texto original)

Lo que se devuelve es solo la fuente y el texto original. El juicio debe realizarlo el profesional sanitario.

Esta política está garantizada por el código. En src/med_lit_mcp/guard.py se definen patrones de expresiones prohibidas, y mediante pruebas se verifica que los textos generados por el propio servidor (descripciones de herramientas, notas y mensajes de error) no contengan expresiones que sugieran juicios clínicos.

Datos que se manejan

No se maneja ningún dato personal de pacientes. Lo único que se envía al exterior son las palabras clave de búsqueda. Las comunicaciones se limitan a los siguientes 4 hosts; cualquier otra comunicación lanza una excepción (ALLOWED_HOSTS en http.py).

Los resultados obtenidos se almacenan en caché en una base de datos SQLite local (por defecto en ~/.cache/med-lit-mcp/). Una vez importado el máster de tarifas de asistencia sanitaria, su búsqueda funciona sin conexión.

Instalación

uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

O clonando el repositorio:

git clone https://github.com/fc0web/med-lit-mcp
cd med-lit-mcp
uv sync
uv run med-lit-mcp

Registro en Claude Desktop / Claude Code

Añada la configuración en claude_desktop_config.json (Claude Desktop) o en .mcp.json (Claude Code).

{
  "mcpServers": {
    "med-lit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fc0web/med-lit-mcp", "med-lit-mcp"],
      "env": {
        "NCBI_EMAIL": "you@example.com"
      }
    }
  }
}

Con Claude Code puede registrarlo en una sola línea.

claude mcp add med-lit -- uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

Herramientas

Ejemplos de uso

「オルフォルグリプロンの第3相試験を、2025年以降のRCTに絞って探して」
  → search_pubmed(term="orforglipron", year_from=2025, study_types=["rct"])

「初診料の点数を調べて」
  → import_shinryo_master(kind="shinryo")   # 初回のみ
  → search_shinryo_hoshu(term="初診料")

Configuración (variables de entorno)

Funciona sin clave de API. Cuando se supera el límite de tasa, en lugar de lanzar una excepción, se espera y se reintenta.

Cuando se utiliza un proxy corporativo o una CA propia

Cuando el cliente MCP inicia el servidor como subproceso, solo hereda un conjunto mínimo de variables de entorno. Si en la red corporativa se utiliza una autoridad de certificación propia, la verificación TLS puede fallar. Indíquelo explícitamente en env de la configuración.

"env": {
  "SSL_CERT_FILE": "/path/to/ca-bundle.crt",
  "REQUESTS_CA_BUNDLE": "/path/to/ca-bundle.crt",
  "HTTPS_PROXY": "http://proxy.example.jp:8080"
}

Lo que no puede hacer (honestamente)

• Búsqueda de texto completo en la biblioteca de guías Minds. Minds renderiza los resultados de búsqueda en el navegador y no dispone de API pública. Técnicamente sería posible acceder mediante un navegador sin interfaz, pero es frágil ante cambios de especificación y las condiciones de uso no están claras, por lo que en v0.1 no se implementa y solo se proporciona la URL de búsqueda.

• Obtención del texto completo de los prospectos de la PMDA. Tampoco dispone de API pública, por lo que se utiliza KEGG como fuente primaria y se incluye la URL de búsqueda de la PMDA. El prospecto es el documento oficial; en la práctica, consulte siempre el texto original en la PMDA.

• Máster de odontología y dispensación. v0.1 solo incluye tres tipos: actos médicos, medicamentos y equipos específicos.

Desarrollo

uv sync
uv run pytest              # 外部APIを叩かないテスト
uv run pytest -m live      # 実APIへの疎通テスト
uv run ruff check .

Fuentes

• NCBI E-utilities

• ClinicalTrials.gov API v2

• KEGG REST API

• Servicio de información de tarifas de asistencia sanitaria

• Biblioteca de guías Minds

• Búsqueda de medicamentos de la PMDA

Licencia

MIT.

Aviso legal

Este software no es un programa de dispositivo médico. No debe utilizarse para tomar decisiones de diagnóstico o tratamiento; la responsabilidad final de verificar los resultados recae en el usuario. Dado que la normativa, los puntos, los precios de los medicamentos y las guías están sujetos a revisiones, en la práctica consulte siempre las fuentes primarias.