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 版本和项目所需的依赖项。
• 在运行服务器之前，要保证已正确配置环境变量。
• 如果在使用过程中遇到问题，请检查日志输出以获取更多详细信息。