学术文献搜索工具

一个整合Semantic Scholar和arXiv的学术文献搜索工具,提供快速并行搜索、规范化输出、去重、引用、参考文献、作者图谱、推荐和arXiv源文件下载等功能,适用于学术研究工作流。

  • by Silung
  • Python
  • 本地部署
  • 247 星标
  • 更新于
在 GitHub 查看 Silung/scholar-search-mcp

使用说明

学者搜索MCP

用于Claude、Cursor和其他MCP客户端中的学术文献工作流程的MCP服务器。

它将Semantic Scholar和arXiv组合成一个统一的工具集,具有快速并行搜索、归一化输出、源感知重复数据删除和实用的研究工具(引用、参考文献、作者图、推荐和arXiv源代码下载)。


目录


为什么这个项目

大多数纸质工具都迫使您选择一种来源或一种API样式。 scholar-search-mcp 为文献检索和图形检索提供了一个MCP层:

  • 一台MCP服务器,多个学术资源
  • 免费首次默认值 (arXiv 无需钥匙即可工作)
  • LLM友好输出 用于下游推理和代理工作流
  • 实际研究行动,不仅搜索
  • 统一搜索: search_papers 并行运行Semantic Scholar+arXiv,并通过规范化标题进行重复数据消除。
  • 研究图表工具:详细信息、引文、参考文献、作者简介/论文和建议。
  • 批处理+源工作流:获取多达500篇论文,并下载/提取arXiv LaTeX源代码。
  • 操作控制:内置缓存加上基于环境的源代码切换(启用/禁用通道)。
  • 来源策略:内置Semantic Scholar+arXiv,默认先免费(arXiv 无密钥),用于更高语义学者限制的可选API密钥。

演示视频

代理人使用学者搜索MCP撰写调查论文。


安装

pip install scholar-search-mcp

需要Python 3.10+。

快速设置(克劳德桌面/光标)

在两个客户端中使用相同的服务器命令:

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
      }
    }
  }
}

SEMANTIC_SCHOLAR_API_KEY 是可选的。仅当您想要更高的语义学者速率限制时才添加它:

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true",
        "SEMANTIC_SCHOLAR_API_KEY": "your-key"
      }
    }
  }
}

区别:

  • 克劳德桌面版:直接编辑本地配置文件。
  • 光标:在游标设置UI(或相应的设置JSON)中添加MCP服务器。

Claude Desktop配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

环境变量

变量 描述
SEMANTIC_SCHOLAR_API_KEY 可选。增加语义学者速率限制。
SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR true/false,默认值 true.
SCHOLAR_SEARCH_ENABLE_ARXIV true/false,默认值 true.
SCHOLAR_SEARCH_CACHE_DIR 可选缓存目录路径。
SCHOLAR_SEARCH_CACHE_TTL_SECONDS 缓存TTL(秒),默认值 86400.
SCHOLAR_ARXIV_SOURCE_DIR 解压缩的arXiv源的默认父目录。

示例(arXiv 仅):

{
  "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "false",
  "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
}

工具列表

工具 目的
search_papers 使用可选功能搜索论文 limit, fields, year, venue.
get_paper_details 通过DOI、arXiv ID、S2 ID或URL获取一篇论文
get_paper_citations 获取引用给定论文的论文。
get_paper_references 获取给定论文的参考文献。
get_author_info 按ID获取作者个人资料
get_author_papers 获取给定作者的论文。
get_paper_recommendations 获得类似的论文推荐。
batch_get_papers 批量获取纸张详细信息(最多500个ID)。
download_arxiv_source 下载并解压arXiv源代码包(tar.gz).

MCP检验员测试

npm install -g @modelcontextprotocol/inspector
mcp-inspector python -m scholar_search_mcp

贡献

问题和PR是受欢迎的:fork repo、创建分支、添加验证/测试,并打开具有明确前后行为的PR。

参考文献