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 & Analytics Knowledge & 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 中

開啟儀表板中的 Scopus，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

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

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

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

Tool	Description
scopus_search	Find publications.
author_search	Find authors and co-authors.
affiliation_search	Find institutions.
author_retrieval	Get author profiles by ID, EID, or ORCID.
affiliation_retrieval	Get an institution profile by ID or EID.
citation_overview	Get yearly citation counts and summaries.
plumx_metrics	Get publication metrics by identifier.
subject_classifications	Look 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.

Error	What to check
`MISSING_API_KEY`	Set `ELSEVIER_API_KEY` in the server's environment.
HTTP 401 or 403	Check your key, subscription, institutional network, and token.
HTTP 429	Check quota headers and `Retry-After` before retrying.
`TIMEOUT` or `NETWORK_ERROR`	Check connectivity to `api.elsevier.com`.
`INVALID_RESPONSE`	Elsevier returned invalid JSON or an unexpected response shape.

API documentation

Development

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

License

來源：README.md，提交 e089062

工具

工具後設資料尚未被收錄。

版本歷史

v0.5.1最新Oct 6, 2026

Environment variable	Description
`ELSEVIER_API_KEY`	Required for all tools except `subject_classifications`.
`ELSEVIER_INST_TOKEN`	Institutional token, if provided by your institution.