论文搜索 MCP

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

目录

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

概述

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

特性

• 多源支持：从 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 自动为 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"
         ],
         "env": {
           "SEMANTIC_SCHOLAR_API_KEY": "" // Optional: For enhanced Semantic Scholar features
         }
       }
     }
   }
   

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

开发环境

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

1. 设置环境：

   
   # Install uv if not installed
   
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   
   
   # Clone repository
   
   git clone https://github.com/openags/paper-search-mcp.git
   
   cd paper-search-mcp
   
   
   
   # Create and activate virtual environment
   
   uv venv
   
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   

2. 安装依赖项：

   
   # Install project in editable mode
   
   uv add -e .
   
   
   
   # Add development dependencies (optional)
   
   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]"  # Install dev dependencies (if added to pyproject.toml)
   
   

3. 进行更改：

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

4. 提交拉取请求：
   推送更改并在 GitHub 上创建 PR。

演示

TODO

计划中的学术平台

• [√] 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 上提出问题。