adamamer20-paper-search-mcp-openai

Paper Search MCP

一个 Model Context Protocol（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 等大模型客户端无缝集成。

---

功能

• 多来源支持：从 arXiv、PubMed、bioRxiv、medRxiv、Google Scholar、IACR ePrint Archive、Semantic Scholar 搜索和下载论文。
• 支持深度研究：提供 OpenAI Deep Research 和 ChatGPT 连接器所需的标准化 search 和 fetch 工具。
• 标准化输出：通过 Paper 类以一致的字典格式返回论文。
• 异步工具：使用 httpx 高效处理网络请求。
• MCP 集成：兼容 MCP 客户端，可增强大模型上下文。
• 可扩展设计：通过扩展 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"
         ],
         "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. Fork 仓库： 在 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. 提交 Pull Request： 推送更改并在 GitHub 上创建 PR。

---

演示

待办事项

计划支持的学术平台

• [√] 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 授权。详情请参阅 LICENSE 文件。

---

祝你使用 paper-search-mcp 研究愉快！如果遇到问题，请提交 GitHub issue。