medRxiv

You can enable AI assistants to search, retrieve metadata, and read medRxiv health sciences preprints through a dedicated MCP server. It acts as a bridge between your AI client and medRxiv, giving you programmatic access to searches, metadata, and paper content so you can build research workflows and analysis prompts.

How to use

Start the MCP server locally and connect your AI assistant or application to the available tools. You can search for papers with keywords or advanced criteria, fetch metadata for a specific paper by its DOI, and download or read downloaded papers from local storage. Use the server as a back-end data source for health sciences research prompts and paper analysis workflows.

How to install

Prerequisites: Python 3.10 or newer, and a Python environment manager like uvx or virtualenv.

Option A: Install Manually via uvx (recommended for development or testing)

uv tool install medRxiv-mcp-server

For development, you can clone the project, set up a virtual environment, and install dependencies.

# Clone the repository
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install required Python packages
uv pip install -r requirements.txt

Starting the server

Run the MCP server using Python. This starts the FastMCP-based service that exposes the medRxiv tools to your MCP clients.

python medrxiv_server.py

Connecting clients via MCP configurations

If you use Claude Desktop, add a local MCP server configuration that runs the server module with Python.

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

Running via Cline (local containerized setup)

You can start the server within a shell that activates a virtual environment and then runs the main script.

bash -lc 'source /home/YOUR/PATH/mcp-server-medRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-medRxiv/medrxiv_server.py'

Usage with a text-based client example

Once the server is running, you can use the three main tools to interact with medRxiv data. Use keyword searches, advanced searches, and metadata lookups to build your workflows.

Available tools

search_medrxiv_key_words

Search medRxiv articles using a keywords string and return a list of matching articles with basic details.

search_medrxiv_advanced

Perform an advanced search on medRxiv with multiple fields such as term, title, authors, dates, and section, returning a list of matching articles.

get_medrxiv_metadata

Fetch detailed metadata for a medRxiv article using its DOI.

deep-paper-analysis

A specialized prompt workflow that analyzes a paper in depth given its paper_id, outlining executive summary, context, methodology, results, implications, and future directions.