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、medRxiv、Google Scholar、IACR ePrint Archive、Semantic Scholar搜索和下载论文。
• 标准化输出：通过Paper类以一致的字典格式返回论文。
• 异步工具：使用httpx高效处理网络请求。
• MCP集成：与MCP客户端兼容，增强LLM上下文。
• 可扩展设计：通过扩展academic_platforms模块轻松添加新的学术平台。

---

安装

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

通过Smithery安装

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

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"
         ],
         "env": {
           "SEMANTIC_SCHOLAR_API_KEY": "" // 可选：增强Semantic Scholar功能
         }
       }
     }
   }
   

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

开发

对于希望修改代码或贡献的开发者：

1. 设置环境：

   # 如果未安装，请安装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. 分叉仓库： 在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. 提交拉取请求： 推送更改并在GitHub上创建PR。

---

演示

<img src="docs/images/demo.png" alt="演示" width="800">

待办事项

计划的学术平台

• [√] arXiv
• [√] PubMed
• [√] bioRxiv
• [√] medRxiv
• [√] Google Scholar
• [√] IACR ePrint Archive
• [√] 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。