Paper Search MCP

一个模型上下文协议 (MCP) 服务器，用于从多个来源搜索和下载学术论文，包括 arXiv、PubMed、bioRxiv 和 Sci-Hub（可选）。专为与 Claude Desktop 等大型语言模型无缝集成而设计。

---

目录

• 概述
• 特性
• 安装
  • 快速开始
    • 安装包
    • 配置 Claude Desktop
  • 用于开发
    • 设置环境
    • 安装依赖
• 贡献
• 演示
• 许可
• 待办事项

---

概述

paper-search-mcp 是一个基于 Python 的 MCP 服务器，使用户能够从各种平台搜索和下载学术论文。它提供了搜索论文（例如，search_arxiv）和下载 PDF（例如，download_arxiv）的工具，使其成为研究人员和 AI 驱动工作流程的理想选择。它使用 MCP Python SDK 构建，可与 Claude Desktop 等 LLM 客户端无缝集成。

---

特性

• 多源支持：从 arXiv、PubMed、bioRxiv 和 Sci-Hub（可选）搜索和下载论文。
• 标准化输出：论文通过 Paper 类以一致的字典格式返回。
• 异步工具：使用 httpx 有效地处理网络请求。
• MCP 集成：与 MCP 客户端兼容，用于增强 LLM 上下文。
• 可扩展设计：通过扩展 academic_platforms 模块轻松添加新的学术平台。

---

安装

可以使用 uv 或 pip 安装 paper-search-mcp。以下是两种方法：一种是立即使用的快速启动，另一种是用于开发的详细设置。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 paper-search-mcp：

npx -y @smithery/cli install @openags/paper-search-mcp --client claude

快速开始

对于想要快速运行服务器的用户：

1. 安装包：

   uv add paper-search-mcp
   

2. 配置 Claude Desktop： 将此配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

   {
     "mcpServers": {
       "paper_search_server": {
         "command": "uv",
         "args": [
           "run",
           "--directory",
           "/path/to/your/paper-search-mcp",
           "-m",
           "paper_search_mcp.server"
         ]
       }
     }
   }
   

   注意：将 /path/to/your/paper-search-mcp 替换为您的实际安装路径。

用于开发

对于想要修改代码或贡献的开发人员：

1. 设置环境：

   # 如果未安装 uv，则安装 uv
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # 克隆存储库
   git clone https://github.com/openags/paper-search-mcp.git
   cd paper-search-mcp
   
   # 创建并激活虚拟环境
   uv venv
   source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
   

2. 安装依赖：

   # 以可编辑模式安装项目
   uv add -e .
   
   # 添加开发依赖项（可选）
   uv add pytest flake8
   

---

贡献

欢迎贡献！以下是如何开始：

1. Fork 存储库： 单击 GitHub 上的“Fork”。

2. 克隆和设置：

   git clone https://github.com/yourusername/paper-search-mcp.git
   cd paper-search-mcp
   pip install -e ".[dev]"  # 安装开发依赖项（如果已添加到 pyproject.toml）
   

3. 进行更改：

   • 在 academic_platforms/ 中添加新平台。
   • 更新 tests/ 中的测试。

4. 提交 Pull Request： 推送更改并在 GitHub 上创建 PR。

---

演示

<img src="docs\images\demo.png" alt="Demo" width="800">

待办事项

计划的学术平台

• [√] arXiv
• [√] PubMed
• [√] bioRxiv/medRxiv
• [√] Google Scholar
• [ ] Semantic Scholar
• [ ] PubMed Central (PMC)
• [ ] Science Direct
• [ ] Springer Link
• [ ] IEEE Xplore
• [ ] ACM Digital Library
• [ ] Web of Science
• [ ] Scopus
• [ ] JSTOR
• [ ] ResearchGate
• [ ] CORE
• [ ] Microsoft Academic

---

许可

此项目已获得 MIT 许可的许可。 有关详细信息，请参见 LICENSE 文件。

---

使用 paper-search-mcp 愉快地研究！ 如果遇到问题，请打开一个 GitHub issue。