paper-search-mcp

@h-lu/paper-search-mcp

0 Stars 86 次浏览 h-lu 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "paper_search_server": {
      "args": [
        "-m",
        "paper_search_mcp.server"
      ],
      "command": "python",
      "env": {
        "CROSSREF_MAILTO": "your_email@example.com",
        "NCBI_API_KEY": "",
        "SEMANTIC_SCHOLAR_API_KEY": ""
      }
    }
  }
}

服务介绍

论文搜索 MCP 服务器

一个用于搜索和下载学术论文的 Model Context Protocol (MCP) 服务器支持多个学术平台专为 Claude DesktopCursor 等 LLM 工具设计

支持的平台

核心平台

平台	搜索	下载	阅读	说明
arXiv				预印本: 物理数学计算机统计生物金融
Semantic Scholar				通用学术搜索2亿+论文AI驱动
PubMed				生物医学文献
bioRxiv				生物学预印本
medRxiv				医学预印本
CrossRef				DOI 元数据1.5亿+记录
IACR				密码学论文
Google Scholar				全学科搜索网页抓取
RePEc/IDEAS				经济学论文库450万+条目
Sci-Hub				下载 2023 年前的付费论文

RePEc/IDEAS 特色功能

RePEc 是最大的开放经济学文献库支持丰富的搜索选项

搜索字段: 全文 / 摘要 / 关键词 / 标题 / 作者

排序方式: 相关性 / 最新 / 最早 / 被引次数 / 最新且相关

文档类型: 期刊文章 / 工作论文 / 书籍章节 / 书籍

机构/期刊过滤:

类别	可选值
研究机构	`nber`, `imf`, `worldbank`, `ecb`, `bis`, `cepr`, `iza`
美联储	`fed`, `fed_ny`, `fed_chicago`, `fed_stlouis`, `fed_sf`
Top 5 期刊	`aer`, `jpe`, `qje`, `econometrica`, `restud`
其他期刊	`jfe`, `jme`, `aej_macro`, `aej_micro`, `aej_applied`

快速开始

安装

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

# 使用 uv 安装 (推荐)
uv pip install -e .

# 或使用 pip
pip install -e .

配置 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

使用 uv (推荐):

{
  "mcpServers": {
    "paper_search_server": {
      "command": "uv",
      "args": ["run", "-m", "paper_search_mcp.server"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "",
        "CROSSREF_MAILTO": "your_email@example.com",
        "NCBI_API_KEY": ""
      }
    }
  }
}

使用 Python:

{
  "mcpServers": {
    "paper_search_server": {
      "command": "python",
      "args": ["-m", "paper_search_mcp.server"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "",
        "CROSSREF_MAILTO": "your_email@example.com",
        "NCBI_API_KEY": ""
      }
    }
  }
}

使用指南

按学科选择工具

通用学术搜索       search_semantic 或 search_crossref
计算机/物理预印本   search_arxiv
生物医学           search_pubmed + download_scihub(doi)
经济学             search_repec (支持 NBER, IMF, Fed, AER 等)
密码学             search_iacr
下载付费论文        download_scihub(doi) [2023年前]

典型工作流

# 1. 搜索论文
papers = search_semantic("climate change agriculture", max_results=5)

# 2. 获取 DOI
doi = papers[0]["doi"]

# 3. 通过 Sci-Hub 下载 (旧论文)
pdf_path = download_scihub(doi)

# 4. 阅读全文
text = read_scihub_paper(doi)

RePEc 经济学搜索示例

# 搜索 NBER 工作论文
search_repec("inflation expectations", series='nber')

# 搜索 AER 期刊文章按最新排序
search_repec("causal inference", series='aer', sort_by='newest')

# 搜索美联储论文限定年份
search_repec("monetary policy", series='fed', year_from=2020)

# 按作者搜索
search_repec("Acemoglu", search_field='author')

# 获取论文详情包含完整摘要
get_repec_paper("https://ideas.repec.org/p/nbr/nberwo/32000.html")

完整工具列表

搜索工具

工具	说明
`search_arxiv`	搜索 arXiv 预印本
`search_semantic`	Semantic Scholar 通用搜索
`search_crossref`	CrossRef DOI 元数据搜索
`search_pubmed`	PubMed 生物医学搜索
`search_biorxiv`	bioRxiv 生物学预印本
`search_medrxiv`	medRxiv 医学预印本
`search_iacr`	IACR 密码学论文
`search_google_scholar`	Google Scholar 搜索
`search_repec`	RePEc/IDEAS 经济学搜索

下载工具

工具	说明
`download_arxiv`	下载 arXiv PDF免费
`download_semantic`	下载开放获取论文
`download_biorxiv`	下载 bioRxiv PDF
`download_medrxiv`	下载 medRxiv PDF
`download_iacr`	下载 IACR PDF
`download_scihub`	通过 Sci-Hub 下载

阅读工具 (PDF Markdown)

工具	说明
`read_arxiv_paper`	阅读 arXiv 论文
`read_semantic_paper`	阅读 Semantic Scholar 论文
`read_biorxiv_paper`	阅读 bioRxiv 论文
`read_medrxiv_paper`	阅读 medRxiv 论文
`read_iacr_paper`	阅读 IACR 论文
`read_scihub_paper`	阅读 Sci-Hub 下载的论文

辅助工具

工具	说明
`get_repec_paper`	获取 RePEc 论文详情完整摘要
`get_crossref_paper_by_doi`	通过 DOI 获取论文元数据

环境变量

变量	用途	推荐
`SEMANTIC_SCHOLAR_API_KEY`	提高 Semantic Scholar 请求限制
`CROSSREF_MAILTO`	CrossRef 礼貌池访问
`NCBI_API_KEY`	提高 PubMed 请求限制	可选
`SCIHUB_MIRROR`	自定义 Sci-Hub 镜像	可选
`PAPER_DOWNLOAD_PATH`	PDF 下载目录 (默认: `~/paper_downloads`)	可选

开发

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

# 创建虚拟环境
uv venv && source .venv/bin/activate

# 安装开发依赖
uv pip install -e .

# 运行测试
uv run pytest tests/ -v

许可证

MIT License

祝研究顺利

查看源码项目主页