medRxiv MCP Server

🔍 Enable AI assistants to search and access medRxiv papers through a simple MCP interface.

The medRxiv MCP Server provides a bridge between AI assistants and medRxiv's preprint repository through the Model Context Protocol (MCP). It allows AI models to search for health sciences preprints and access their content in a programmatic way.

🤝 Contribute • 📝 Report Bug

✨ Core Features

• 🔎 Paper Search: Query medRxiv papers with custom search strings or advanced search parameters ✅
• 🚀 Efficient Retrieval: Fast access to paper metadata ✅
• 📊 Metadata Access: Retrieve detailed metadata for specific papers using DOI ✅
• 📊 Research Support: Facilitate health sciences research and analysis ✅
• 📄 Paper Access: Download and read paper content 📝
• 📋 Paper Listing: View all downloaded papers 📝
• 🗃️ Local Storage: Papers are saved locally for faster access 📝
• 📝 Research Prompts: A set of specialized prompts for paper analysis 📝

🚀 Quick Start

Installing via Smithery

To install medRxiv Server for Claude Desktop automatically via Smithery:

claude

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

Cursor

Paste the following into Settings → Cursor Settings → MCP → Add new server:

• 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 "{}"

Installing Manually

Install using uv:

uv tool install medRxiv-mcp-server

For development:

# 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

📊 Usage

Start the MCP server:

python medrxiv_server.py

Once the server is running, you can use the provided MCP tools in your AI assistant or application. Here are some examples of how to use the tools:

Example 1: Search for papers using keywords

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

Example 2: Perform an advanced search

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)

Example 3: Get metadata for a specific paper

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

These examples demonstrate how to use the three main tools provided by the medRxiv MCP Server. Adjust the parameters as needed for your specific use case.

🛠 MCP Tools

The medRxiv MCP Server provides the following tools:

search_medrxiv_key_words

Search for articles on medRxiv using key words.

Parameters:

• key_words (str): Search query string
• num_results (int, optional): Number of results to return (default: 10)

Returns: List of dictionaries containing article information

search_medrxiv_advanced

Perform an advanced search for articles on medRxiv.

Parameters:

• term (str, optional): General search term
• title (str, optional): Search in title
• author1 (str, optional): First author
• author2 (str, optional): Second author
• abstract_title (str, optional): Search in abstract and title
• text_abstract_title (str, optional): Search in full text

... View full README on GitHub