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.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 4e7e6d1fd7ad055487319316e2c69294ff9b8e7322e7a73a600b8b428efd3acc
MD5 096bf1954a0958f2c09728a521a24f8b
BLAKE2b-256 0a7fe1df30c7d9d25cd9eb14c6df75e06d424741155b4038bf940933d6cdf0c5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iflow_mcp_jackkuo666_mcp_server_biorxiv-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.5 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 04e87697cdd9671237d62b98651a66d805d9233c7437528728c3c2b39dbcdd64
MD5 492c89237ed3cebe24f6d6f4c677b72d
BLAKE2b-256 24dd9abafb416a10b3978a4f1501640972eb71a7f2c5dc9d833117f0b7f6ba93

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