medRxiv

The medRxiv MCP Server provides a bridge between AI assistants and the medRxiv preprint repository using the Model Context Protocol (MCP). It exposes tools that let you search for health sciences preprints, retrieve detailed metadata, and access paper content through a simple MCP interface. Specifically, you can search for articles with keywords or using an advanced term-based query, fetch metadata for a given DOI, and then download or read paper content that has been saved locally. When integrated with an MCP-enabled assistant, these tools enable conversational access to up-to-date medRxiv information without leaving your assistant workflow. The server runs as a Python process and exposes three main tools that your agent can invoke: search_medrxiv_key_words, search_medrxiv_advanced, and get_medrxiv_metadata. Start the server with python medrxiv_server.py, then call the tools via the MCP interface in your assistant or application. For example, use search_medrxiv_key_words to find papers matching COVID-19, or use get_medrxiv_metadata with a DOI to retrieve structured article details.

Prerequisites:

• Python 3.10+ installed on your system
• Internet access for dependency installation

Manual installation steps:

1. Clone the repository (or download themedRxiv MCP Server files): git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git cd medRxiv-MCP-Server

2. Create and activate a Python virtual environment (optional but recommended): uv venv source .venv/bin/activate

3. Install required dependencies: pip install FastMCP requests beautifulsoup4

4. Run the MCP server locally: python medrxiv_server.py

5. Verify the server starts and is listening for MCP tool calls. You can adjust the environment or config as needed and restart the server when changes are made.

Tips and notes:

• The server relies on web scraping via medRxiv; ensure compliance with medRxiv terms of service.
• You can integrate this MCP server with Claude Desktop or other MCP-enabled clients by pointing to the server (e.g., mcpServers.medrxiv with command 'python' and args ['medrxiv_server.py']).
• Available tools include: search_medrxiv_key_words (keyword-based search), search_medrxiv_advanced (advanced search with multiple parameters), and get_medrxiv_metadata (fetch metadata by DOI).
• For development, you can install in a virtual environment and install development dependencies if you modify medrxiv_server.py or medrxiv_web_search.py.
• If you run into connection or parsing issues, check your network access and verify the medRxiv site structure, as web scrapers may require updates over time.