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

mseep_mcp_server_biorxiv-0.1.1.tar.gz (3.3 kB view details)

Uploaded Source

Built Distribution

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

mseep_mcp_server_biorxiv-0.1.1-py3-none-any.whl (3.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mseep_mcp_server_biorxiv-0.1.1.tar.gz
  • Upload date:
  • Size: 3.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for mseep_mcp_server_biorxiv-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4057185dbd96818276da3a3c20a5cefa4783eb15eebcd617b99759f3d9f2ecb2
MD5 9c8f6f1cba671a1763565239b184b76d
BLAKE2b-256 f3c38ba382013ff4f12801c9f1ba2081124fc86244862f93608527fca272529e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mseep_mcp_server_biorxiv-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 076f58ee2795ff95ec2e0aaaabfd3b9da3170aa9a7b84d5413d0317859776d18
MD5 6cf2e24a3443b6398ce96a1b31ea6b91
BLAKE2b-256 664799190cbac40a4202c7d13c2eaa8817b3b0de32137772a8ed0b235db2becb

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