Scopus

Name: Scopus
Author: Anddrrew

本地服务

github.com/Anddrrew搜索与检索03 周前更新

代码仓库

关于 Scopus

Scopus 是用于查询 Elsevier Scopus 数据的 MCP 服务，适用于研究和文献计量工作流。它提供搜索、档案、引用和 PlumX 工具，并保留 API 返回的原始 JSON 字段。

主要功能

01搜索出版物、作者和机构
02获取作者与机构档案
03查询年度引用摘要
04查询 PlumX 指标
05返回原始 API JSON

适用场景

01查找出版物和合著者
02查看作者或机构档案
03检查年度引用数
04获取出版物指标

MCP 相关

将 Elsevier Scopus API 操作作为工具提供给 MCP 客户端，包括出版物搜索、档案获取、引用数据和 PlumX 指标。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "anddrrew-scopus": {
      "command": "npx",
      "args": [
        "-y",
        "scopus-mcp"
      ],
      "env": {
        "ELSEVIER_API_KEY": "<ELSEVIER_API_KEY>",
        "ELSEVIER_INST_TOKEN": "<ELSEVIER_INST_TOKEN>"
      }
    }
  }
}

启动命令npx -y scopus-mcp

需要配置的环境变量

ELSEVIER_API_KEY密钥Elsevier API key from https://dev.elsevier.com. Required for every tool except subject_classifications; data access depends on your subscription and institutional access.

ELSEVIER_INST_TOKEN密钥Institutional token supplied by Elsevier, if available for your institution. Used alongside the API key for institutional access.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmscopus-mcp0.5.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
ver	string	否	资源版本标志：facetexpand、allexpand、new；用逗号或分号分隔。
date	string	否	出版年份或包含首尾年份的年份范围，例如 2024 或 2020-2024。
sort	string	否	最多三个以逗号分隔的排序字段；+ 表示升序，- 表示降序，例如 -coverDate,+creator。
subj	string	否	用于筛选的 Scopus 学科领域代码，例如 COMP。
view	any	否	响应视图。默认为 STANDARD；COMPLETE 和 COMPONENT 需要相应的 Scopus 权限。若指定 field，则此参数会被覆盖。
alias	boolean	否	作者 ID 搜索是否包含已被取代的档案。省略时使用 API 默认值 true。
count	integer	否	此页的最大结果数。默认为 25；STANDARD 最多为 200，COMPLETE/COMPONENT 最多为 25。指定 field 时，由 Elsevier 确定实际视图和上限。
field	string	否	以逗号分隔的响应字段，例如 identifier,title,doi。此参数会覆盖 view；省略的字段不会出现在响应中。
query	string	是	Scopus 原生出版物查询，例如 TITLE-ABS-KEY(machine learning) AND PUBYEAR > 2020。
reqId	string	否	调用方提供的请求标识符，用于联系 Elsevier 支持。
start	integer	否	从零开始的结果偏移量。与 cursor 二选一。请求窗口的起始位置 + count 不得超过 5000；省略 count 时默认为 25。
cursor	string	否	首个游标页面使用 *，之后使用上一响应中的 search-results.cursor["@next"]。与 start 二选一；查询和其他选项须保持不变。
facets	string	否	原生 facet 表达式，例如 pubyear;subjarea(count=10,sort=fd)。
content	any	否	要搜索的 Scopus 内容集合：all、core 或 dummy。
suppressNavLinks	boolean	否	禁止顶层导航链接。省略时使用 API 默认值 false。

详细介绍

scopus-mcp

用于 Elsevier Scopus API 的 MCP 服务。通过 npx 使用 stdio 运行，并保留 API 的参数名称和 JSON 响应。

快速开始

需要 Node.js 22.22.0 或更高版本、npm，以及支持 stdio 的 MCP 客户端。从 Elsevier Developer Portal 获取 API 密钥，并将此服务添加到客户端配置中：

{
  "mcpServers": {
    "scopus": {
      "command": "npx",
      "args": ["-y", "scopus-mcp"],
      "env": {
        "ELSEVIER_API_KEY": "your-elsevier-api-key"
      }
    }
  }
}

重新加载客户端以连接。若要固定版本，请在 args 中使用 scopus-mcp@<version>。

配置

环境变量	说明
`ELSEVIER_API_KEY`	除 `subject_classifications` 外，所有工具都需要此变量。
`ELSEVIER_INST_TOKEN`	如果所在机构提供了机构令牌，请设置此变量。

在客户端的 env 对象中设置凭据。此服务不会加载 .env 文件。数据和视图的访问权限取决于您的 Elsevier 订阅和机构访问权限。

服务会在 MCP serverInfo 和 stderr 上的启动日志中报告其版本。

工具

工具	说明
scopus_search	查找出版物。
author_search	查找作者和合著者。
affiliation_search	查找机构。
author_retrieval	通过 ID、EID 或 ORCID 获取作者档案。
affiliation_retrieval	通过 ID 或 EID 获取机构档案。
citation_overview	获取年度引用次数和摘要。
plumx_metrics	通过标识符获取出版物指标。
subject_classifications	查询学科代码；无需 API 密钥。

每次调用都会发出一个 API 请求。要获取后续页面，请使用工具的分页参数。请求支持取消，并设有 30 秒超时；不会自动重试或重定向。

响应和错误

结果遵循各工具的 outputSchema。原始 API JSON 会同时返回在 structuredContent 和文本内容块中，不会重塑字段或转换值。

可用的配额标头会以字符串形式返回在 _meta["scopus-mcp/headers"] 中： X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 和 Retry-After。

API 调用失败时会返回 isError: true，并附带包含 code、message 以及（如有）HTTP status 的 JSON 文本错误。凭据会被脱敏。无效参数会在发出 API 请求前被拒绝。

错误	检查事项
`MISSING_API_KEY`	在服务的环境中设置 `ELSEVIER_API_KEY`。
HTTP 401 或 403	检查密钥、订阅、机构网络和令牌。
HTTP 429	重试前检查配额标头和 `Retry-After`。
`TIMEOUT` 或 `NETWORK_ERROR`	检查与 `api.elsevier.com` 的连接。
`INVALID_RESPONSE`	Elsevier 返回了无效 JSON 或意外的响应结构。