Semantic Scholar MCP Server

npm version

一个 MCP (Model Context Protocol) 服务器，提供 Semantic Scholar 学术搜索功能。

功能特性

论文搜索、详情查询、引用分析
作者搜索和学术档案查询
基于论文的智能推荐
支持多种论文 ID 格式 (DOI, ArXiv, PMID 等)
内置速率限制和自动重试机制

快速开始

在 Claude Desktop 中使用

编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "semanticscholar": {
      "command": "npx",
      "args": ["-y", "@xbghc/semanticscholar-mcp"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your-api-key"
      }
    }
  }
}

配置 API Key (可选)

Semantic Scholar API 可以无需认证使用，但有速率限制。申请 API Key 可获得更高的请求配额。

访问 Semantic Scholar API 申请 API Key
在配置中设置 SEMANTIC_SCHOLAR_API_KEY 环境变量

可用工具

论文相关

工具	描述
`search_papers`	搜索学术论文，支持年份、学科、引用数等过滤条件
`get_paper`	获取论文详情，支持多种 ID 格式
`get_paper_citations`	获取引用该论文的文献列表
`get_paper_references`	获取论文的参考文献列表
`batch_get_papers`	批量获取多篇论文详情 (最多 500 篇)

作者相关

工具	描述
`search_authors`	搜索学术作者
`get_author`	获取作者详情 (h-index, 论文数等)
`get_author_papers`	获取指定作者的论文列表

使用示例

在支持 MCP 的客户端中直接对话即可使用：

搜索关于 transformer attention 的论文

查看论文 ARXIV:1706.03762 的详细信息

找出引用了 "Attention Is All You Need" 的论文

推荐与这篇论文相似的研究

支持的论文 ID 格式

Semantic Scholar ID: 204e3073870fae3d05bcbc2f6a8e263d9b72e776
DOI: DOI:10.1038/nature12373
ArXiv: ARXIV:1706.03762
PubMed: PMID:19872477
Corpus ID: CorpusId:123456

其他安装方式

从源码安装

git clone https://github.com/xbghc/semanticscholar-mcp.git
cd semanticscholar-mcp
npm install
npm run build

配置文件使用本地路径：

{
  "mcpServers": {
    "semanticscholar": {
      "command": "node",
      "args": ["/path/to/semanticscholar-mcp/dist/index.js"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your-api-key"
      }
    }
  }
}

全局安装

npm install -g @xbghc/semanticscholar-mcp

开发

项目结构

semanticscholar-mcp/
├── src/
│   ├── index.ts              # 入口文件
│   ├── server.ts             # MCP 服务器
│   ├── api/
│   │   ├── client.ts         # API 客户端
│   │   ├── rate-limiter.ts   # 速率限制 (p-queue)
│   │   ├── backoff.ts        # 指数退避重试
│   │   └── types.ts          # 类型定义
│   ├── tools/
│   │   ├── papers.ts         # 论文工具
│   │   ├── authors.ts        # 作者工具
│   │   └── recommendations.ts # 推荐工具
│   └── utils/
│       ├── errors.ts         # 错误处理
│       └── fields.ts         # 字段常量
├── tests/                    # 测试文件
├── package.json
└── tsconfig.json

常用命令

# 开发模式
npm run dev

# 构建
npm run build

# 运行测试
npm test

速率限制

模式	请求间隔
有 API Key	2 秒
无 API Key	5 秒

遇到 429 错误时会自动指数退避重试 (1s → 2s → 4s → 8s → 16s)。

API 参考

本服务器基于 Semantic Scholar Academic Graph API。

主要端点：

/graph/v1/paper/search - 论文搜索
/graph/v1/paper/{paper_id} - 论文详情
/graph/v1/author/search - 作者搜索
/recommendations/v1/papers - 论文推荐

许可证

MIT

semanticscholar-mcp