论文搜索 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 构建，它与 LLM 客户端如 Claude Desktop 平滑集成。

功能

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

安装

paper-search-mcp 可以使用 uv 或 pip 安装。下面有两种方法：快速开始立即使用和详细的开发安装。

使用 Smithery 快速安装

通过 Smithery 快速安装：

# 在终端运行以下命令：
uv add @openags/paper-search-mcp

这将自动下载并安装 paper-search-mcp 以及所有依赖项。

使用 pip 安装

如果无法使用 Smithery，可以手动安装：

1. 克隆存储库：

   git clone https://github.com/yourusername/paper-search-mcp.git
   cd paper-search-mcp
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 安装包：

   python setup.py install
   

快速开始

安装完成后，按照以下步骤快速上手：

1. 初始化 MCP 服务：

   from paper_search_mcp import PaperSearchMCP
   server = PaperSearchMCP()
   

2. 启动服务器：

   uv run your_project_name
   

3. 使用 API 搜索论文：

   curl http://localhost:5000/api/search?q=quantum+computing
   

4. 下载 PDF：

   curl -o paper.pdf http://localhost:5000/api/download/1234
   

配置 Claude Desktop

要将 paper-search-mcp 与 Claude Desktop 集成，请按照以下步骤操作：

1. 在 Claude 中配置 MCP 代理：

   proxies:
     paper_search_mcp:
       type: http
       url: http://localhost:5000
   

2. 使用 Claude 调用论文搜索功能：

   from claude import Claude
   claire = Claude(license_key)
   response = claire(
       "搜索关于量子计算的最新论文。",
       tools=[PaperSearchMCP Tool]
   )
   

开发用途

设置环境

1. 克隆存储库：

   git clone https://github.com/yourusername/paper-search-mcp.git
   cd paper-search-mcp
   

2. 创建虚拟环境并安装依赖项：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
   pip install -r requirements.txt
   

3. 运行测试：

   pytest tests/
   

贡献

欢迎贡献！请按照以下步骤提交代码：

1. Fork 仓库并在您的分支上进行更改。
2. 提交并推送更改。
3. 创建 Pull Request 到主分支。

如何添加新平台

要添加新的学术平台，请按照以下步骤操作：

1. 在 academic_platforms/ 文件夹中创建一个新的模块。
2. 实现搜索和下载功能。
3. 更新测试用例。
4. 提交到仓库。

演示

待办事项

计划中的学术平台

• [√] 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 上打开一个问题。