Skip to main content

An MCP server for searching and retrieving articles from bioRxiv

Project description

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

  1. Clone the repository:

    git clone https://github.com/JackKuo666/bioRxiv-MCP-Server.git
    cd bioRxiv-MCP-Server
    
  2. 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:

  1. search_biorxiv_key_words: Search for articles on bioRxiv using keywords.
  2. search_biorxiv_advanced: Perform an advanced search for articles on bioRxiv with multiple parameters.
  3. 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 FastMCP
  • biorxiv_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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1.tar.gz.

File metadata

  • Download URL: iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1.tar.gz
Algorithm Hash digest
SHA256 199fb357582fdced64251f7afbe77fdffa6820b1d610e6621ed84d8dde84dbcb
MD5 519fba47bddfedb09e82d72c0ef62503
BLAKE2b-256 206c412fe6a196c82f5f572b5cb3856cbb1aadf8dab45dbc5c1b2504377b3469

See more details on using hashes here.

File details

Details for the file iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8a4de02b5813f70e97d49f291d4aa73c5039c6e780aca585b52ab2491c691534
MD5 9c2d3696aa5407bf9ee1fc5dcd3daf99
BLAKE2b-256 9c0ec8e44f1eea5e676b33972c9b1488e2b6d66ec8482a834fd2333d9d60382f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page