Sci Hub MCP Server

🚀 Sci-Hub MCP 服務器

🔍 本項目允許 AI 助手藉助 Sci-Hub 開展學術論文的搜索、訪問與分析工作，提供了簡單易用的 MCP 接口。通過 Model Context Protocol (MCP)，Sci-Hub MCP 服務器在 AI 助手和 Sci-Hub 的學術文獻庫之間搭建起溝通的橋樑。這使得 AI 模型能夠依據 DOI、標題或關鍵詞來搜索科學論文，獲取論文的元數據，還能以編程的方式下載 PDF 文本。

🚀 快速開始

先決條件

• 需要安裝 Python 3.10 及以上版本。
• 要安裝 FastMCP 庫。

安裝

1. 克隆項目倉庫：

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

2. 安裝所需的依賴項：

   pip install -r requirements.txt
   

啟動服務

啟動 MCP 服務器：

python sci_hub_server.py

在 Claude Desktop 中使用

Mac OS 系統

在 claude_desktop_config.json 中添加以下配置：

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

Windows 系統

{
    "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": []
        }
    }
}

✨ 主要特性

• 🔎 支持使用數字對象唯一標識符 (DOI) 搜索論文。
• 🔍 可使用標題搜索論文，支持全文或部分標題搜索。
• 🔑 能通過關鍵詞發現特定研究領域的相關論文。
• 📊 可以獲取論文的詳細元數據。
• 📄 當論文的 PDF 文本內容可用時，可進行下載。

💻 使用示例

基礎用法

使用 DOI 搜索論文

你可以要求 AI 助手通過 DOI 搜索論文，示例如下：

你能搜索 Sci-Hub 上具有 DOI 10.1038/nature09492 的論文嗎？

使用標題搜索論文

你可以使用標題在 Sci-Hub 搜索論文，示例如下：

你能找到題為《選擇創傷後壓力障礙篩選和結果研究的評估工具》的論文嗎？

使用關鍵詞搜索論文

你可以通過關鍵詞在 Sci-Hub 搜索相關論文，示例如下：

你能通過關鍵詞“人工智能”搜索相關論文嗎？

📚 詳細文檔

MCP 工具

Sci-Hub MCP 服務器提供了以下實用工具：

1. search_scihub_by_doi：使用 DOI 在 Sci-Hub 搜索論文。
2. search_scihub_by_title：使用標題在 Sci-Hub 搜索論文。
3. search_scihub_by_keyword：使用關鍵詞在 Sci-Hub 搜索相關論文。
4. download_scihub_pdf：從 Sci-Hub 下載論文 PDF。
5. get_paper_metadata：通過 DOI 獲取論文的元數據信息。

項目結構

• sci_hub_server.py：這是項目的主服務器文件。
• requirements.txt：該文件列出了項目所需的依賴項。

⚠️ 注意事項

⚠️ 重要提示

• 請確保你安裝了正確的 Python 版本和項目所需的依賴項。
• 在運行服務器之前，要保證已正確配置環境變量。
• 如果在使用過程中遇到問題，請檢查日誌輸出以獲取更多詳細信息。