Skip to main content
Glama
Silung

scholar-search-mcp

by Silung

Scholar Search MCP

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

它将 Semantic Scholar + arXiv 整合为一个统一的工具集,具备快速并行搜索、标准化输出、源感知去重以及实用的研究工具(引用、参考文献、作者图谱、推荐和 arXiv 源码下载)。


目录


Related MCP server: arXiv Research Assistant MCP Server

为什么选择本项目

大多数论文工具迫使你只能选择一个来源或一种 API 风格。scholar-search-mcp 为文献搜索和图谱检索提供了一个统一的 MCP 层:

  • 一个 MCP 服务器,多个学术来源

  • 默认优先使用免费源(arXiv 无需密钥即可工作)

  • 对 LLM 友好的输出,便于后续推理和智能体工作流

  • 实用的研究操作,不仅仅是搜索

  • 统一搜索:search_papers 并行运行 Semantic Scholar + arXiv,并按标准化标题进行去重。

  • 研究图谱工具:详情、引用、参考文献、作者资料/论文以及推荐。

  • 批量 + 源工作流:获取多达 500 篇论文,并下载/提取 arXiv LaTeX 源码。

  • 操作控制:内置缓存以及基于环境变量的源开关(启用/禁用通道)。

  • 源策略:内置 Semantic Scholar + arXiv,默认优先使用免费源(arXiv 无需密钥),可选 API 密钥以提高 Semantic Scholar 的限额。

演示视频

智能体使用 Scholar Search MCP 撰写综述论文。

安装

pip install scholar-search-mcp

需要 Python 3.10+。

快速设置 (Claude Desktop / Cursor)

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

{
  "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 是可选的。仅当你需要提高 Semantic Scholar 的速率限制时才添加它:

{
  "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"
      }
    }
  }
}

区别:

  • Claude Desktop:直接编辑本地配置文件。

  • Cursor:在 Cursor 设置界面(或相应的设置 JSON)中添加 MCP 服务器。

Claude Desktop 配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

环境变量

变量

描述

SEMANTIC_SCHOLAR_API_KEY

可选。提高 Semantic Scholar 的速率限制。

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 Inspector 进行测试

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

贡献

欢迎提交 Issue 和 PR:Fork 仓库,创建分支,添加验证/测试,并提交一个行为描述清晰的 PR。

许可证

MIT

参考资料

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    An MCP server for searching and downloading academic papers from multiple sources including arXiv, PubMed, bioRxiv, and Sci-Hub, designed for seamless integration with large language models like Claude Desktop.
    5
    57
    1,921 PyPI
    2,774
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    A streamlined MCP server that connects AI assistants to arXiv's vast collection of academic papers, enabling search, retrieval, and analysis of research papers.
    7
    1
    -