AI导哈

学术搜索服务器

一个提供Semantic Scholar学术搜索功能的MCP服务器，支持论文搜索、作者查询和智能推荐。

  • by xbghc
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 xbghc/semanticscholar-mcp

使用说明

Semantic Scholar MCP Server

一个 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 可获得更高的请求配额。

  1. 访问 Semantic Scholar API 申请 API Key
  2. 在配置中设置 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 获取指定作者的论文列表

推荐

工具 描述
get_recommendations 基于指定论文获取推荐的相关论文

使用示例

在支持 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

相关 MCP