Sci Hub MCP Server

🚀 Sci-Hub MCP Server

🔍 Allows AI assistants to search, access, and analyze academic papers via Sci-Hub using a simple MCP interface.

The Sci-Hub MCP Server bridges AI assistants with Sci-Hub's academic literature library through the Model Context Protocol (MCP). It enables AI models to search for scientific papers by DOI, title, or keywords, obtain their metadata, and programmatically download PDF texts.

✨ Features

• 🔎 Search for papers using Digital Object Identifier (DOI) ✅
• 🔍 Search for papers by title (supports full or partial titles) ✅
• 🔑 Discover relevant papers in specific research areas using keywords ✅
• 📊 Obtain detailed metadata ✅
• 📄 Download the full PDF text content (when available) ✅

🚀 Quick Start

Prerequisites

• Python version 3.10+
• FastMCP library

Installation

1. Clone the repository:

   git clone https://github.com/JackKuo666/Sci-Hub-MCP-Server.git
   cd Sci-Hub-MCP-Server
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

💻 Usage Examples

Start the MCP Server

python sci_hub_server.py

Use with Claude Desktop

Add the following configuration to claude_desktop_config.json (Mac OS):

{
  "mcpServers": {
    "scihub": {
      "command": "python",
      "args": ["-m", "sci_hub_server.py"]
      }
  }
}

(Windows version):

{
  "mcpServers": {
    "scihub": {
      "command": "C:\\Users\\YOUR\\PATH\\miniconda3\\envs\\mcp_server\\python.exe",
      "args": [
        "D:\\code\\YOUR\\PATH\\Sci-Hub-MCP-Server\\sci_hub_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

🛠 MCP Tools

The Sci-Hub MCP Server provides the following tools:

1. search_scihub_by_doi: Search for papers on Sci-Hub using a DOI.
2. search_scihub_by_title: Search for papers on Sci-Hub using a title.
3. search_scihub_by_keyword: Search for relevant papers on Sci-Hub using keywords.
4. download_scihub_pdf: Download a paper's PDF from Sci-Hub.
5. get_paper_metadata: Obtain metadata information for a paper via its DOI.

Search for Papers Using a DOI

You can ask an AI assistant to search for a paper using a DOI:

Can you search for a paper with the DOI 10.1038/nature09492 on Sci-Hub?

Search for Papers Using a Title

You can search for papers on Sci-Hub using a title:

Can you find a paper titled "Selecting Assessment Tools for Post-Traumatic Stress Disorder Screening and Outcomes Research"?

Search for Papers Using Keywords

You can search for relevant papers on Sci-Hub using keywords:

Can you search for relevant papers using the keyword "artificial intelligence"?

📚 Documentation

Project Structure

• sci_hub_server.py: The main server file.
• requirements.txt: The list of dependencies.

⚠️ Important Note

• Ensure you have installed the correct Python version and dependencies.
• Make sure you have correctly configured the environment variables before running the server.
• If you encounter any issues, check the log output for more information.