mcpField
S
Scopus Plus MCP

Scopus Plus MCP

Local
github.comSearch0Updated 3w ago

About Scopus Plus MCP

Scopus Plus MCP gives researchers literature search, citation-network analysis, and bibliometrics across Scopus and OpenAlex. It also audits citation links and exports data for analysis tools.

Key features

  1. 01Search papers, authors, and full text
  2. 02Build citation networks and lineages
  3. 03Analyze journal metrics and topic trends
  4. 04Audit citations and reference lists
  5. 05Export BibTeX and network data

Use cases

  1. 01Trace citation lineages for a research topic
  2. 02Compare journal metrics and publishing trends across fields
  3. 03Check citation contexts and retraction status

MCP support

As an MCP server, it exposes search, citation-analysis, audit, and bibliometrics tools to compatible clients. Clients can use Scopus and OpenAlex sources; Scopus features require the user's API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"michalhron-scopus-plus": {
"command": "uvx",
"args": [
"scopus-plus-mcp"
],
"env": {
"SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
"SCOPUS_INSTTOKEN": "<SCOPUS_INSTTOKEN>",
"OPENALEX_API_KEY": "<OPENALEX_API_KEY>"
}
}
}
}
Run commanduvx scopus-plus-mcp
Environment variables to set
SCOPUS_API_KEYSecretElsevier API key from dev.elsevier.com (required to start the server).
SCOPUS_INSTTOKENSecretInstitutional token for subscriber access off campus.
OPENALEX_API_KEYSecretFree OpenAlex key; raises the daily OpenAlex budget tenfold.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiscopus-plus-mcp0.24.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Scopus Plus MCP: search, full text, citation networks, journal quality and bibliometrics, for Claude and other AI assistants

Tests PyPI Python 3.10+ License: MIT

Search the literature, trace who cites whom across generations, map research fronts and intellectual bases, and pull the counts, metrics and bibliography you need, from a conversation. It is an MCP server, so any MCP client can use it: Claude Desktop, Claude Code, Cursor.

What you get

README imageCitation networks
Coupling, co-citation, multi-generation lineages and the network within any paper set, with SPC/SPLC/SPNP main paths, key routes, RPYS and a historiograph. More
README imageAudited, not just built
Citer sets verified across search strategies, reference lists checked against Crossref, and the sentences behind each citation. More
README imageTwo data sources
Scopus by default. Add source="openalex" to run the same analyses without a Scopus subscription. OpenAlex topics with a field-relative journal quality cut build corpora that span disciplines. More
README imageBibliometrics
Where a topic is published and in which quartile, journals above a percentile cut-off, counts per year, themes over time, BibTeX. More
README imageFull-text search
Find Elsevier papers that use a term in their body, and see how often and where each one uses it. More
README imageHonest about access
One call tells you which tools your Scopus access supports, and why the rest fail. More
README imageMain-path skill
Walks Claude from a query to a drawn main path map. Ships with the Claude Code plugin. More
README imageTested
510 test functions, CI on Linux, macOS and Windows, and a live check of every tool against the real APIs. More

How it compares with the other Scopus MCP servers and with bibliometrics packages (bibliometrix, pybliometrics, VOSviewer, Pajek): comparison.

Ask things like

Map the research front around these six papers on organizing visions.

Trace two generations of work citing Swanson & Ramiller (1997) and show me the main path.

Build the citation network of every Basket of Eight paper citing the organizing-vision papers, and show how the main path cites its predecessors.

How has publishing on "digital transformation" grown since 2010?

Build a corpus on digital transformation across IS, strategy and marketing, top-quartile journals only, and show which fields cite which.

Get SJR and CiteScore for the Basket of Eight, and BibTeX for the papers we just found.

More, with the tools each one triggers: prompt examples.

How it works

You ask in your MCP client. scopus-plus-mcp calls Scopus, OpenAlex, Crossref, Semantic Scholar and open-access sources, and writes JSON, CSV, GraphML, Pajek, PNG, HTML and BibTeX files to disk.

You ask in plain words and the assistant picks the tools. The server calls Scopus with your own key, and Crossref, Semantic Scholar and open-access sources where a tool needs them. Results come back as a summary in the reply, and the full data goes to files that Pajek, VOSviewer, Gephi or Zotero can open. Responses are cached, and long jobs run in the background.

Tools

36 tools in six families: search, citations, networks, audit, bibliometrics, diagnostics. Sixteen also run on OpenAlex.

FamilyToolsGuide
README imageSearch and recordssearch_scopus · search_all · search_fulltext · get_abstract_details · resolve_identifier · search_authors · get_author_profile · get_fulltextsearch
README imageCitationsget_references · get_citing_paperssearch
README imageNetworksbibliographic_coupling · co_citation · citation_lineage · citation_network · historiograph · rpys · research_frontsnetworks
README imageAuditresolve_citers · citation_context · path_transmission · coding_agreement · index_coverage · check_retractionsaudit
README imageBibliometricspublication_counts · topic_landscape · topic_profile · thematic_evolution · get_journal_metrics · find_journals · get_bibtex · import_recordsbibliometrics
README imageDiagnostics and jobsdiagnose_connection · get_quota_status · get_server_info · job_status · job_resultaccess

Every parameter of every tool: tool reference.

Install

You need an API key from the Elsevier Developer Portal (register with your institutional email). OpenAlex needs no key.

Claude Desktop, one click:

  1. Download scopus-plus-mcp-<version>.mcpb from the latest release.
  2. Open it (or drag it into Settings → Extensions), click Install, and paste your API key when asked. Claude stores it securely.

Claude Code, two commands:

claude plugin marketplace add michalhron/scopus-plus-mcp
claude plugin install scopus-plus-mcp@michalhron

Then make your key available, either in your shell (export SCOPUS_API_KEY=...) or, better, in the OS secret store.

Any other MCP client (needs uv):

{
  "mcpServers": {
    "scopus-plus": {
      "command": "uvx",
      "args": ["scopus-plus-mcp"],
      "env": { "SCOPUS_API_KEY": "YOUR_KEY" }
    }
  }
}

Then ask your assistant to run diagnose_connection. It checks your key and tells you which tools your Scopus access supports.

The Claude Code plugin also installs the main-path skill, which walks Claude through a main path analysis from a query to a drawn map. For Claude Desktop, zip its folder and upload it as a skill.

Documentation

Feature guides:

  • Search, records and full text: finding papers and authors, identifiers, importing exports, full-text search and retrieval.
  • Citation networks and main paths: coupling, co-citation, lineages, main path analysis, historiograph, RPYS, research fronts.
  • Audit: verified citer sets, reference-list completeness, citation contexts, the transmission audit, retractions.
  • Bibliometrics and bibliography: counts per year, topic landscape, journal cut-offs and metrics, thematic evolution, BibTeX.

Reference and setup:

Origins

Formerly citation-network-mcp (and before that michalhron/scopus-mcp). This project began as a fork of qwe4559999/scopus-mcp by thinktraveller and qwe4559999, which provides Scopus search, abstracts, author profiles and citing papers. Everything since version 0.2 was developed here by Michal Hron. MIT licensed; see LICENSE.

Scopus and ScienceDirect are trademarks of Elsevier B.V. This project is independent and not affiliated with or endorsed by Elsevier; it uses their public APIs with your own key and subscription.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.