MedRxiv MCP Server: AI Search for Preprints

Overview

The MedRxiv MCP Server exposes medRxiv preprints to AI assistants and other MCP-compatible clients via the Model Context Protocol (MCP). It acts as a lightweight API layer that lets language models perform programmatic searches, retrieve metadata and download papers from medRxiv without having to scrape HTML or manage individual document storage.

This server is useful for developers building research assistants, literature-monitoring bots, or any AI workflow that needs quick, precise access to the latest health-sciences preprints. By returning structured results (titles, authors, DOIs, dates, metadata and saved local copies), it simplifies downstream tasks like summarization, citation extraction, or inclusion into retrieval-augmented generation pipelines.

Features

• Search medRxiv by keyword queries or structured/advanced fields
• Fetch full metadata for a paper given its DOI
• Download and persist paper files locally for faster subsequent access
• Expose tools via MCP so assistants (Claude Desktop, Cursor, Cline, Windsurf, etc.) can call the server directly
• Small footprint and easy to run locally or inside a virtual environment
• Example prompts and integration snippets to accelerate adoption

Installation / Configuration

Clone and install from the repository:

git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

Create a virtual environment and install dependencies:

python -m venv .venv
source .venv/bin/activate   # macOS / Linux
# .venv\Scripts\activate    # Windows
pip install -r requirements.txt

Start the MCP server:

python medrxiv_server.py

Alternative installation options:

• Install via Smithery (for automatic register with supported clients):

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

• Install with uv tool:

uv tool install medRxiv-mcp-server

Client configuration examples (Claude Desktop):

macOS / Linux:

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

Windows (adjust python path):

{
  "mcpServers": {
    "medrxiv": {
      "command": "C:\\Path\\To\\Python\\python.exe",
      "args": ["-m", "medrxiv-mcp-server"]
    }
  }
}

CLine example (start inside virtualenv):

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOU/.venv/bin/activate && python /home/YOU/medRxiv-MCP-Server/medrxiv_server.py"
      ]
    }
  }
}

Available Tools

The server exposes a set of MCP-callable tools for searching and fetching medRxiv content.

Table of primary tools:

Example: call a search tool from an MCP client (Python-style pseudocode):

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

Advanced search example:

result = await mcp.use_tool("search_medrxiv_advanced", {
    "term": "SARS-CoV-2",
    "author1": "Smith",
    "start_date": "2020-01-01",
    "end_date": "2023-12-31",
    "num_results": 3
})

Get metadata by DOI:

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

Returned structures are JSON-friendly dictionaries containing title, authors, doi, abstract (when available), publication date, and (if downloaded) file path to the saved paper.

Use Cases

• Research assistant: Let an LLM search medRxiv for recent preprints on a topic, fetch metadata, and produce concise summaries or evidence tables.
• Rapid screening: Automate initial screening by querying keywords or date ranges and returning short metadata lists for human review.
• Literature monitoring: Combine scheduled MCP queries with alerts to detect new papers matching a search profile (e.g., a drug name or study design).
• Augmented writing: Provide AI models with direct access to primary preprint content for citation-aware drafts, method comparisons, or result consolidation.
• Systematic review triage: Use advanced searches to populate candidate pools that can then be exported for inclusion/exclusion workflows.

Notes and Tips

• Results are saved locally to speed up repeat access; ensure you have sufficient disk space if you bulk-download PDFs.
• Date formats use ISO (YYYY-MM-DD) in advanced search parameters.
• This server follows the MCP convention: clients invoke tools by name and pass parameter objects; responses are JSON-serializable.
• Check the GitHub repository for updates, issue reporting, and contribution guidelines: https://github.com/JackKuo666/medRxiv-MCP-Server

If you plan to integrate this into production workflows, consider running the server in a managed environment and adding monitoring / logging for usage and errors.