Paper Download MCP Server

论文下载MCP服务器

英语| 简体中文

MCP服务器，用于通过DOI、arXiv ID或URL下载学术论文。

所得

• paper_download：下载一篇或多篇论文（每次通话1-50篇）
• paper_get_metadata：无需下载即可获取纸质元数据
• 可选的PDF到Markdown转换 to_markdown

快速入门（MCP客户端）

配置前，请确保 uvx 可用：

uvx --version

克劳德代码

添加为项目范围的MCP服务器：

claude mcp add --transport stdio --scope project --env PAPER_DOWNLOAD_EMAIL=your-email@university.edu paper-download -- uvx paper-download-mcp

这写道 .mcp.json 在当前项目中。等效配置：

{
  "mcpServers": {
    "paper-download": {
      "command": "uvx",
      "args": ["paper-download-mcp"],
      "env": {
        "PAPER_DOWNLOAD_EMAIL": "your-email@university.edu"
      }
    }
  }
}

法典

使用CLI添加：

codex mcp add paper-download --env PAPER_DOWNLOAD_EMAIL=your-email@university.edu -- uvx paper-download-mcp

等效 ~/.codex/config.toml 代码片段：

[mcp_servers.paper-download]
command = "uvx"
args = ["paper-download-mcp"]

[mcp_servers.paper-download.env]
PAPER_DOWNLOAD_EMAIL = "your-email@university.edu"

克劳德桌面版

编辑克劳德桌面MCP配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "paper-download": {
      "command": "uvx",
      "args": ["paper-download-mcp"],
      "env": {
        "PAPER_DOWNLOAD_EMAIL": "your-email@university.edu"
      }
    }
  }
}

编辑文件后重新启动Claude Desktop。

配置

必需的

• PAPER_DOWNLOAD_EMAIL：Unpaywall API用法所必需。

可选（高级）

• PAPER_DOWNLOAD_OUTPUT_DIR：全局回退输出目录。

在大多数情况下，您不需要 PAPER_DOWNLOAD_OUTPUT_DIR.喜欢超车 output_dir 在 paper_download 当您需要特定位置时，可以调用工具。

出于兼容性考虑，仍支持传统环境变量：

• SCIHUB_CLI_EMAIL
• SCIHUB_OUTPUT_DIR

工具

paper_download

下载具有可配置并发性的论文（默认 parallel=10). 如果 parallel=1，论文按顺序处理，项目之间有2秒的延迟。 OA优先路由首先使用OpenAlex和Unpaywall；默认情况下，MCP运行时禁用CORE。

参数：

• identifiers （必填）： list[str]，1-50个项目
• output_dir （可选）：目标目录（默认使用运行时回退： PAPER_DOWNLOAD_OUTPUT_DIR 或 ./downloads)
• parallel （可选）：并发工作者， 1-50 （默认值 10)
• to_markdown （可选）：将PDF转换为Markdown(false 默认情况下）
• md_output_dir （可选）：Markdown目录（默认 /md)

示例：

paper_download(["10.1038/nature12373"])
paper_download(["10.1038/nature12373", "2301.00001"], output_dir="/path/to/papers")
paper_download(["10.1038/nature12373", "10.1126/science.169.3946.635"], parallel=10)
paper_download(["10.1038/nature12373"], to_markdown=true)

paper_get_metadata

快速获取元数据（无需下载PDF）。

参数：

• identifier （必填）：DOI、arXiv ID或URL

例子：

paper_get_metadata("10.1038/nature12373")

故障排除

PAPER_DOWNLOAD_EMAIL environment variable is required

集 PAPER_DOWNLOAD_EMAIL 在您的MCP服务器配置中。

uvx: command not found

安装 uv，然后重新运行MCP配置。

下载路径错误

传递一个可写目录 output_dir例如：

paper_download(["10.1038/nature12373"], output_dir="/absolute/path")

法律声明

该工具可以访问来自多个来源的论文，包括Unpaywall和Sci-Hub。您有责任遵守您所在司法管辖区的版权和当地法律。

许可证

MIT。看 LICENSE.