Scopus

io.github.Anddrrewv0.5.1更新于 Oct 6, 2026

Scopus search, author and affiliation profiles, citation data, and PlumX metrics via Elsevier APIs.

已验证STDIO仅桌面Data & AnalyticsKnowledge & Memory

概览

AI 生成的概览

让助手通过 Elsevier API 检索 Scopus 文献、作者与机构，并获取引用数据和 PlumX 指标。

功能
将 Elsevier Scopus API 封装为 MCP 工具：scopus_search 检索文献，author_search 与 affiliation_search 查找作者和机构，author_retrieval 与 affiliation_retrieval 按 ID、EID 或 ORCID 获取档案，citation_overview 获取逐年引用次数，plumx_metrics 获取出版物指标。subject_classifications 无需 API 密钥即可查询学科代码。每次调用发起一次 API 请求，原始 API JSON 会同时放在 structuredContent 和文本块中返回，配额响应头通过 _meta 暴露。
适用场景
适合助手需要文献计量或学术元数据的场景：查找某主题的论文、查看作者或机构档案，或为一批出版物收集引用次数和 PlumX 指标。
运行要求
以 npx 启动的本地进程，需要 Node.js 22.22.0 或更高版本、npm，以及支持 stdio 的 MCP 客户端。除 subject_classifications 外，所有工具都需要来自 Elsevier 开发者门户的 ELSEVIER_API_KEY；ELSEVIER_INST_TOKEN 为可选的机构访问令牌。凭据放在客户端的 env 对象中，不读取 .env 文件。需要能访问 api.elsevier.com。
安装前请注意
服务器需要在其环境中提供密钥 ELSEVIER_API_KEY，可选提供 ELSEVIER_INST_TOKEN；它不读取 .env 文件，因此需在客户端配置中设置。数据访问取决于你的 Elsevier 订阅和机构访问权限，请求受 API 配额限制（HTTP 429 及 Retry-After）。调用为只读查询；不会自动重试或跟随重定向，并有 30 秒超时。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Scopus，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

scopus-mcp

[npm version] [Node.js] [License: MIT]

An MCP server for the Elsevier Scopus API. Runs over stdio with npx and keeps the API's parameter names and JSON responses.

Quick start

Requires Node.js 22.22.0 or newer, npm, and an MCP client with stdio support. Get an API key from the Elsevier Developer Portal and add this server to your client's configuration:

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

Reload the client to connect. To pin a release, use scopus-mcp@<version> in args.

Configuration

Environment variableDescription
ELSEVIER_API_KEYRequired for all tools except subject_classifications.
ELSEVIER_INST_TOKENInstitutional token, if provided by your institution.

Set credentials in the client's env object. The server does not load .env files. Access to data and views depends on your Elsevier subscription and institutional access.

The server reports its version in MCP serverInfo and the startup log on stderr.

Tools

ToolDescription
scopus_searchFind publications.
author_searchFind authors and co-authors.
affiliation_searchFind institutions.
author_retrievalGet author profiles by ID, EID, or ORCID.
affiliation_retrievalGet an institution profile by ID or EID.
citation_overviewGet yearly citation counts and summaries.
plumx_metricsGet publication metrics by identifier.
subject_classificationsLook up subject codes; no API key needed.

Each call makes one API request. For additional pages, use the tool's pagination parameters. Requests support cancellation and a 30-second timeout; retries and redirects are not automatic.

Responses and errors

Results follow each tool's outputSchema. The original API JSON is returned in both structuredContent and a text content block, without reshaping fields or converting values.

Available quota headers are returned as strings in _meta["scopus-mcp/headers"]: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and Retry-After.

API failures return isError: true and a JSON text error with code, message, and, when available, an HTTP status. Credentials are redacted. Invalid arguments are rejected before an API request.

ErrorWhat to check
MISSING_API_KEYSet ELSEVIER_API_KEY in the server's environment.
HTTP 401 or 403Check your key, subscription, institutional network, and token.
HTTP 429Check quota headers and Retry-After before retrying.
TIMEOUT or NETWORK_ERRORCheck connectivity to api.elsevier.com.
INVALID_RESPONSEElsevier returned invalid JSON or an unexpected response shape.

API documentation

Development

See Contributing for local setup and changes, and Releases for publishing.

License

MIT © 2026 Andrii Baran. Independent project, not affiliated with Elsevier.

来源：README.md，提交 e089062

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.5.1最新Oct 6, 2026