金大哥 - paper-search-mcp-openai MCP 详情

article

README

🚀 论文搜索MCP

paper-search-mcp 是一个基于模型上下文协议（MCP）的服务器，可让用户从多个来源搜索和下载学术论文，支持的来源包括 arXiv、PubMed、bioRxiv 以及（可选的）Sci-Hub。该项目专为与 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 深度研究和 ChatGPT 连接器所需的标准化 search 和 fetch 工具。
标准化输出：通过 Paper 类以一致的字典格式返回论文。
异步工具：使用 httpx 高效处理网络请求。
MCP 集成：与 MCP 客户端兼容，可增强大语言模型的上下文。
可扩展设计：通过扩展 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

快速安装

对于希望快速运行服务器的用户：

安装包：

uv add paper-search-mcp

配置 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": "" // 可选：用于增强 Semantic Scholar 功能
            }
        }
    }
}

⚠️ 重要提示

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

开发环境安装

对于想要修改代码或做出贡献的开发者：

设置环境：

# 如果未安装 uv，请先安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆仓库
git clone https://github.com/openags/paper-search-mcp.git
cd paper-search-mcp

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

安装依赖：

# 以可编辑模式安装项目
uv add -e .

# 添加开发依赖（可选）
uv add pytest flake8

🤝 贡献指南

我们欢迎大家贡献代码！以下是贡献的步骤：

Fork 仓库：在 GitHub 上点击 “Fork”。
克隆并设置：

git clone https://github.com/yourusername/paper-search-mcp.git
cd paper-search-mcp
pip install -e ".[dev]"  # 安装开发依赖（如果已添加到 pyproject.toml）

进行更改：
- 在 academic_platforms/ 中添加新平台。
- 在 tests/ 中更新测试。
提交拉取请求：推送更改并在 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。

paper-search-mcp-openai