medRxiv

Busca y recupera artículos de medRxiv, el servidor de prepublicaciones para ciencias de la salud.

Documentación

medRxiv MCP Server

smithery badge

🔍 Permite a los asistentes de IA buscar y acceder a artículos de medRxiv a través de una interfaz MCP sencilla.

El servidor MCP de medRxiv proporciona un puente entre los asistentes de IA y el repositorio de preprints de medRxiv mediante el Protocolo de Contexto de Modelo (MCP). Permite que los modelos de IA busquen preprints de ciencias de la salud y accedan a su contenido de forma programática.

🤝 Contribuir • 📝 Reportar un error

✨ Características principales

  • 🔎 Búsqueda de artículos: Consulta artículos de medRxiv con cadenas de búsqueda personalizadas o parámetros de búsqueda avanzada ✅
  • 🚀 Recuperación eficiente: Acceso rápido a los metadatos de los artículos ✅
  • 📊 Acceso a metadatos: Recupera metadatos detallados de artículos específicos usando DOI ✅
  • 📊 Soporte de investigación: Facilita la investigación y el análisis en ciencias de la salud ✅
  • 📄 Acceso a artículos: Descarga y lee el contenido de los artículos 📝
  • 📋 Listado de artículos: Ve todos los artículos descargados 📝
  • 🗃️ Almacenamiento local: Los artículos se guardan localmente para un acceso más rápido 📝
  • 📝 Indicaciones de investigación: Un conjunto de indicaciones especializadas para el análisis de artículos 📝

🚀 Inicio rápido

Instalación mediante Smithery

Para instalar el servidor medRxiv para Claude Desktop automáticamente mediante Smithery:

claude

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client claude --config "{}"

Cursor

Pegue lo siguiente en Configuración → Configuración de Cursor → MCP → Agregar nuevo servidor:

  • Mac/Linux
npx -y @smithery/cli@latest run @JackKuo666/medrxiv-mcp-server --client cursor --config "{}" 

Windsurf

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client windsurf --config "{}"

CLine

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client cline --config "{}"

Instalación manual

Instale usando uv:

uv tool install medRxiv-mcp-server

Para desarrollo:

# Clone and set up development environment
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# Create and activate virtual environment
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

📊 Uso

Inicie el servidor MCP:

python medrxiv_server.py

Una vez que el servidor esté en ejecución, puede usar las herramientas MCP proporcionadas en su asistente de IA o aplicación. Aquí hay algunos ejemplos de cómo usar las herramientas:

Ejemplo 1: Buscar artículos usando palabras clave

result = await mcp.use_tool("search_medrxiv_key_words", {
    "key_words": "COVID-19 vaccine efficacy",
    "num_results": 5
})
print(result)

Ejemplo 2: Realizar una búsqueda avanzada

result = await mcp.use_tool("search_medrxiv_advanced", {
    "term": "COVID-19",
    "author1": "MacLachlan",
    "start_date": "2020-01-01",
    "end_date": "2023-12-31",
    "num_results": 3
})
print(result)

Ejemplo 3: Obtener metadatos de un artículo específico

result = await mcp.use_tool("get_medrxiv_metadata", {
    "doi": "10.1101/2025.03.09.25323517"
})
print(result)

Estos ejemplos demuestran cómo usar las tres herramientas principales proporcionadas por el servidor MCP de medRxiv. Ajuste los parámetros según sea necesario para su caso de uso específico.

🛠 Herramientas MCP

El servidor MCP de medRxiv proporciona las siguientes herramientas:

search_medrxiv_key_words

Busca artículos en medRxiv usando palabras clave.

Parámetros:

  • key_words (str): Cadena de consulta de búsqueda
  • num_results (int, opcional): Número de resultados a devolver (predeterminado: 10)

Devuelve: Lista de diccionarios que contienen información del artículo

search_medrxiv_advanced

Realiza una búsqueda avanzada de artículos en medRxiv.

Parámetros:

  • term (str, opcional): Término de búsqueda general
  • title (str, opcional): Buscar en el título
  • author1 (str, opcional): Primer autor
  • author2 (str, opcional): Segundo autor
  • abstract_title (str, opcional): Buscar en el resumen y el título
  • text_abstract_title (str, opcional): Buscar en el texto completo, el resumen y el título
  • section (str, opcional): Sección de medRxiv
  • start_date (str, opcional): Fecha de inicio para el rango de búsqueda (formato: YYYY-MM-DD)
  • end_date (str, opcional): Fecha de fin para el rango de búsqueda (formato: YYYY-MM-DD)
  • num_results (int, opcional): Número de resultados a devolver (predeterminado: 10)

Devuelve: Lista de diccionarios que contienen información del artículo

get_medrxiv_metadata

Obtiene metadatos de un artículo de medRxiv usando su DOI.

Parámetros:

  • doi (str): DOI del artículo

Devuelve: Diccionario que contiene metadatos del artículo

Uso con Claude Desktop

Agregue esta configuración a su claude_desktop_config.json:

(Mac OS)

{
  "mcpServers": {
    "medrxiv": {
      "command": "python",
      "args": ["-m", "medrxiv-mcp-server"]
      }
  }
}

(Versión de Windows):

{
  "mcpServers": {
    "medrxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "medrxiv-mcp-server"
      ]
    }
  }
}

Uso con Cline

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/mcp-server-medRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-medRxiv/medrxiv_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Después de reiniciar Claude Desktop, las siguientes capacidades estarán disponibles:

Búsqueda de artículos

Puede pedirle a Claude que busque artículos usando consultas como:

Can you search medRxiv for recent papers about genomics?

La búsqueda devolverá información básica sobre los artículos coincidentes, incluyendo:

• Título del artículo

• Autores

• DOI

Obtención de detalles del artículo

Una vez que tenga un DOI, puede solicitar más detalles:

Can you show me the details for paper 10.1101/003541?

Esto devolverá:

• Título completo del artículo

• Autores

• Fecha de publicación

• Resumen del artículo

• Enlaces a formatos disponibles (PDF/HTML)

📝 Pendientes

download_paper

Descargar un artículo y guardarlo localmente.

read_paper

Leer el contenido de un artículo descargado.

list_papers

Listar todos los artículos descargados.

📝 Indicaciones de investigación

El servidor ofrece indicaciones especializadas para ayudar a analizar artículos académicos:

Indicación de análisis de artículos

Un flujo de trabajo integral para analizar artículos académicos que solo requiere un ID de artículo:

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

Esta indicación incluye:

  • Instrucciones detalladas para usar las herramientas disponibles (list_papers, download_paper, read_paper, search_papers)
  • Un flujo de trabajo sistemático para el análisis de artículos
  • Estructura de análisis integral que cubre:
    • Resumen ejecutivo
    • Contexto de la investigación
    • Análisis de metodología
    • Evaluación de resultados
    • Implicaciones prácticas y teóricas
    • Direcciones futuras de investigación
    • Impactos más amplios

📁 Estructura del proyecto

  • medrxiv_server.py: La implementación principal del servidor MCP usando FastMCP
  • medrxiv_web_search.py: Contiene la lógica de web scraping para buscar en medRxiv

🔧 Dependencias

  • Python 3.10+
  • FastMCP
  • asyncio
  • logging
  • requests (para web scraping, usado en medrxiv_web_search.py)
  • beautifulsoup4 (para web scraping, usado en medrxiv_web_search.py)

Puede instalar las dependencias requeridas usando:

pip install FastMCP requests beautifulsoup4

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar un Pull Request.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.

🙏 Agradecimientos

Este proyecto está inspirado y se basa en el trabajo realizado en el proyecto arxiv-mcp-server.

⚠️ Aviso legal

Esta herramienta es solo para fines de investigación. Respete los términos de servicio de medRxiv y utilícela de manera responsable.