bioRxiv MCP Server
🔍 Enable AI assistants to search and access bioRxiv papers through a simple MCP interface.
The bioRxiv MCP Server provides a bridge between AI assistants and bioRxiv's preprint repository through the Model Context Protocol (MCP). It allows AI models to search for biology preprints and access their metadata in a programmatic way.
🤝 Contribute • 📝 Report Bug
✨ Core Features
- 🔎 Paper Search: Query bioRxiv papers with keywords or advanced search ✅
- 🚀 Efficient Retrieval: Fast access to paper metadata ✅
- 📊 Metadata Access: Retrieve detailed metadata for specific papers ✅
- 📊 Research Support: Facilitate biological 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
Prerequisites
- Python 3.10+
- FastMCP library
Installation
-
Clone the repository:
git clone https://github.com/JackKuo666/bioRxiv-MCP-Server.git cd bioRxiv-MCP-Server -
Install the required dependencies:
pip install -r requirements.txt
Installing via Smithery
To install bioRxiv Server for Claude Desktop automatically via Smithery:
claude
npx -y @smithery/cli@latest install @JackKuo666/biorxiv-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/biorxiv-mcp-server --client cursor --config "{}"
Windsurf
npx -y @smithery/cli@latest install @JackKuo666/biorxiv-mcp-server --client windsurf --config "{}"
CLine
npx -y @smithery/cli@latest install @JackKuo666/biorxiv-mcp-server --client cline --config "{}"
Usage with Claude Desktop
Add this configuration to your claude_desktop_config.json:
(Mac OS)
{
"mcpServers": {
"biorxiv": {
"command": "python",
"args": ["-m", "biorxiv-mcp-server"]
}
}
}
(Windows version):
{
"mcpServers": {
"biorxiv": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": [
"-m",
"biorxiv-mcp-server"
]
}
}
}
Using with Cline
{
"mcpServers": {
"biorxiv": {
"command": "bash",
"args": [
"-c",
"source /home/YOUR/PATH/mcp-server-bioRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-bioRxiv/biorxiv_server.py"
],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
📊 Usage
Start the MCP server:
python biorxiv_server.py
🛠 MCP Tools
The bioRxiv MCP Server provides the following tools:
search_biorxiv_key_words: Search for articles on bioRxiv using keywords.search_biorxiv_advanced: Perform an advanced search for articles on bioRxiv with multiple parameters.get_biorxiv_metadata: Fetch metadata for a bioRxiv article using its DOI.
Searching Papers
You can ask the AI assistant to search for papers using queries like:
Can you search bioRxiv for recent papers about genomics?
Getting Paper Details
Once you have a DOI, you can ask for more details:
Can you show me the metadata for the paper with DOI 10.1101/123456?
📁 Project Structure
biorxiv_server.py: The main MCP server implementation using FastMCPbiorxiv_web_search.py: Contains the web scraping logic for searching bioRxiv
🔧 Dependencies
- Python 3.10+
- FastMCP
- asyncio
- logging
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the MIT License.
⚠️ Disclaimer
This tool is for research purposes only. Please respect bioRxiv's terms of service and use this tool responsibly.
Metadata
Release files for iflow-mcp_biorxiv-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_biorxiv_mcp_server-0.1.0.tar.gz | 5.9 kB | Without provenance | Details for iflow_mcp_biorxiv_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_biorxiv_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_biorxiv_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 12.7 kB
Release files / iflow_mcp_biorxiv_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_biorxiv_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 5.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cccb7632d7d840002c1cd05b92dd32ba002b8b688424356756d1aa52677d74ed
|
|
BLAKE2b-256 checksum How to use checksums |
5545dff3441c90bb75c7ef53d126a89d4b284dd87c2db0fb9cef1e6d0df16a79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Release files / iflow_mcp_biorxiv_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_biorxiv_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b7493e46481f6e4633111dca22a27043ee3ed9cccb819c93ff3a84b003e80733
|
|
BLAKE2b-256 checksum How to use checksums |
3128cfcbd9b29cb65bf7c43ec7ec4d66f665b64da9fd35b238e60f1c3250d67a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Security for iflow-mcp_biorxiv-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.