medRxiv MCP Server

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:

git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server\n\n# 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)

MCP Tools

The medRxiv MCP Server provides the following tools:\n\n### 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, abstract, and title
• section (str, optional): Section of medRxiv
• start_date (str, optional): Start date for search range (format: YYYY-MM-DD)
• end_date (str, optional): End date for search range (format: YYYY-MM-DD)
• num_results (int, optional): Number of results to return (default: 10) Returns: List of dictionaries containing article information

get_medrxiv_metadata

Fetch metadata for a medRxiv article using its DOI. Parameters:

• doi (str): DOI of the article Returns: Dictionary containing article metadata

License

This project is licensed under the MIT License.