paper-search-mcp

🚀 论文搜索 MCP 服务

paper-search-mcp 是一个基于 Python 的 MCP 服务器，可让用户从多个平台搜索和下载学术论文。它提供搜索和下载工具，适合研究人员和 AI 驱动的工作流，还能与 LLM 客户端如 Claude Desktop 平滑集成。

🚀 快速开始

使用 Smithery 快速安装

通过 Smithery 快速安装：

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

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

启动服务

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]
)

✨ 主要特性

• 多来源支持：从 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. 克隆存储库：

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