金大哥 - paper-find-mcp MCP 详情

article

README

🚀 论文查找MCP服务器

这是一个基于模型上下文协议（MCP）的服务器，用于从多个平台搜索和下载学术论文。它专为Claude Desktop、Cursor等大语言模型（LLM）工具设计。

🚀 快速开始

安装

从PyPI安装（推荐）：

# 使用uv（推荐）
uv pip install paper-find-mcp

# 或者使用pip
pip install paper-find-mcp

从源代码安装：

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

# 使用uv安装
uv pip install -e .

# 或者使用pip
pip install -e .

配置Claude Desktop

编辑~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

使用uvx（推荐，无需预先安装）：

{
  "mcpServers": {
    "paper_find_server": {
      "command": "uvx",
      "args": ["paper-find-mcp"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "",
        "CROSSREF_MAILTO": "your_email@example.com",
        "NCBI_API_KEY": "",
        "PAPER_DOWNLOAD_PATH": "~/paper_downloads"
      }
    }
  }
}

使用pip安装的包：

{
  "mcpServers": {
    "paper_find_server": {
      "command": "paper-find-mcp",
      "args": [],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "",
        "CROSSREF_MAILTO": "your_email@example.com",
        "NCBI_API_KEY": "",
        "PAPER_DOWNLOAD_PATH": "~/paper_downloads"
      }
    }
  }
}

✨ 主要特性

支持的平台

核心平台

| 平台 | 搜索 | 下载 | 阅读 | 描述 | |------|:------:|:--------:|:----:|-------------| | arXiv | ✅ | ✅ | ✅ | 预印本：物理、数学、计算机科学、统计学、生物学、金融学 | | Semantic Scholar | ✅ | ✅ | ✅ | 通用学术搜索，超过2亿篇论文，由人工智能驱动 | | 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 | | 顶级5本期刊 | aer, jpe, qje, econometrica, restud | | 其他期刊 | jfe, jme, aej_macro, aej_micro, aej_applied |

💻 使用示例

基础用法

按学科选择工具

通用学术搜索    → search_semantic 或 search_crossref
计算机科学/物理学预印本 → search_arxiv
生物医学 → search_pubmed + download_scihub(doi)
经济学 → search_repec（支持NBER、IMF、美联储、《美国经济评论》等）
密码学 → 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')

# 搜索《美国经济评论》期刊文章，按最新排序
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/h-lu/paper-find-mcp.git
cd paper-find-mcp

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

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

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

📄 许可证

本项目采用MIT许可证。

🎓 祝研究顺利！

paper-find-mcp