morosss-sdfsdf

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 等 LLM 客户端无缝集成。

---

功能

• 多来源支持：搜索和下载来自 arXiv、PubMed、bioRxiv、medRxiv、Google Scholar、IACR ePrint Archive、Semantic Scholar 的论文。
• 标准化输出：通过 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"
         ],
         "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. 提交 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 文件。

---

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