Skip to main content
Glama
easyscholar-mcp

easyscholar-mcp

by tanskeran

easyscholar-mcp

English | 简体中文

An unofficial MCP server that lets AI agents (Claude, Cursor, Cline, Codex, and any other MCP client) look up a journal's impact factor, JCR quartile and CAS (Chinese Academy of Sciences) zone through the easyScholar open API.

Not affiliated with or endorsed by easyScholar. You need your own easyScholar secret key.

Tools

Tool

What it does

journal_rank(publication_name)

Looks up one journal

journal_ranks(publication_names)

Looks up up to 50 journals per call, about 0.6 s apart to stay under the rate limit

Each result looks like this:

{
  "query": "NeuroImage: Clinical",
  "found": true,
  "metrics": {
    "impact_factor": "4.2",
    "impact_factor_5y": "4.6",
    "jcr_quartile": "Q1",
    "cas_zone": "医学2区",
    "cas_subcategory_zone": "神经成像2区。",
    "jci": "1.07",
    "esi_field": "神经科学与行为"
  },
  "custom_ranks": ["新锐分区: 2区"]
}
  • Keys are stable English names. Values are passed through from easyScholar as strings, and are often in Chinese.

  • Only fields that easyScholar has data for are present.

  • If a name is not found as given, the server tries up to three common respellings by itself: it drops a leading "The", swaps & and and, drops punctuation, and turns : into -. When one of them matches, matched_name shows which.

  • If nothing matches, found is false and the result lists the spellings in tried plus a hint. The agent can then try the abbreviation or the full title.

  • Found results are cached locally for 30 days, so repeated lookups don't use your API quota. See Configuration.

  • The secret key is read only from the environment and is replaced with *** in any error text the server returns.

Metric keys

Key

Meaning

impact_factor, impact_factor_5y

JCR impact factor, 5-year impact factor

jcr_quartile

JCR quartile (Q1–Q4)

jci

Journal Citation Indicator

esi_field

ESI subject field

cas_zone, cas_subcategory_zone, cas_top

CAS journal zone (upgraded edition): major category, subcategory, Top journal

cas_zone_basic

CAS journal zone (basic edition)

cas_warning

CAS early-warning journal list

xinrui_zone, xinrui_subcategory_zone, xinrui_top

Xinrui (新锐) journal zone

ssci_quartile, esci_quartile, ei, pku_core, cssci, cscd, ccf

Other indexes and lists

Related MCP server: Scopus MCP Server

Setup

  1. Get a secret key from your easyScholar account (Personal Center → Open API).

  2. Add the server to your MCP client. Requires uv.

{
  "mcpServers": {
    "easyscholar": {
      "command": "uvx",
      "args": ["easyscholar-mcp"],
      "env": { "EASYSCHOLAR_SECRET_KEY": "your-key" }
    }
  }
}

Claude Code

claude mcp add easyscholar -e EASYSCHOLAR_SECRET_KEY=your-key -- uvx easyscholar-mcp

Claude Desktop, Cursor, Cline, Windsurf

These clients use the mcpServers format shown above. Paste it into:

Client

Config file

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json)

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project)

Cline

MCP Servers → Configure → cline_mcp_settings.json

Windsurf

~/.codeium/windsurf/mcp_config.json

VS Code (Copilot agent mode)

.vscode/mcp.json. VS Code asks for the key the first time and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "easyscholar-key", "description": "easyScholar secret key", "password": true }
  ],
  "servers": {
    "easyscholar": {
      "type": "stdio",
      "command": "uvx",
      "args": ["easyscholar-mcp"],
      "env": { "EASYSCHOLAR_SECRET_KEY": "${input:easyscholar-key}" }
    }
  }
}

Codex CLI

~/.codex/config.toml:

[mcp_servers.easyscholar]
command = "uvx"
args = ["easyscholar-mcp"]
env = { EASYSCHOLAR_SECRET_KEY = "your-key" }

Keeping the key out of config files

Set EASYSCHOLAR_SECRET_KEY as a user environment variable, and reference it as "${EASYSCHOLAR_SECRET_KEY}" in clients that expand variables.

Configuration

Environment variable

Default

Meaning

EASYSCHOLAR_SECRET_KEY

(required)

Your easyScholar secret key

EASYSCHOLAR_CACHE_DAYS

30

How long found results are cached. 0 turns the cache off

EASYSCHOLAR_CACHE_DIR

%LOCALAPPDATA%\easyscholar-mcp on Windows, ~/.cache/easyscholar-mcp elsewhere

Where the cache file is kept

The cache holds journal metrics only, never the key.

License

MIT

Available Tools

2 tools
journal_rankA

Look up one journal's impact factor and quartiles/zones via easyScholar (查期刊影响因子和分区).

publication_name: journal title, e.g. "NeuroImage: Clinical", "Annals of Neurology".

If the name is not found as given, a few respellings are tried automatically (drop leading "The", '&' <-> 'and', drop punctuation, ':' -> '-'); "matched_name" then shows the spelling that matched. Found results are cached locally for 30 days.

Returns {"query", "found", "metrics", "custom_ranks"?, "matched_name"?} or {"found": false, "tried", "hint"} / {"found": false, "error"}. metrics keys: impact_factor (JCR IF), impact_factor_5y, jcr_quartile (Q1-Q4), jci, esi_field, cas_zone (中科院分区升级版), cas_subcategory_zone, cas_top, cas_zone_basic (中科院基础版), cas_warning (中科院预警), xinrui_zone (新锐分区), ssci_quartile, esci_quartile, ei, pku_core, cssci, cscd, ccf. Only keys easyScholar has data for are present; values are strings. If found is false, do not retry the spellings in "tried"; try the abbreviation or full title.

Inputs: publication_name (required).

journal_ranksA

Look up several journals at once (max 50; ~0.6 s between requests). Same output per journal as journal_rank.

Inputs: publication_names (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools are clearly separated by cardinality: journal_rank handles one title, journal_ranks handles up to 50, and both descriptions state this explicitly. The singular/plural distinction is the only potential confusion point, but the descriptions make selection straightforward.

    Naming Consistency4/5

    Both names follow the same noun-based pattern with a singular/plural pair (journal_rank / journal_ranks), which is predictable and readable. The only minor deviation is that neither uses a verb prefix like get_ or lookup_, so the action must be inferred from the noun.

    Tool Count3/5

    The domain is deliberately narrow (journal metric lookup), so two tools are defensible, but it sits at the thin end where a single tool with a list parameter could have covered both cases. The batch tool does earn its place given the ~0.6s per-request throttle.

    Completeness3/5

    Core metric retrieval is well covered, including caching, spelling fallbacks, and rich metric keys. However, there is no way to search or discover journals by keyword, ISSN, or category, so an agent that doesn't already know the exact title has a dead end beyond the automatic respelling attempts.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides access to journal partition tables, impact factors, and warning lists from Chinese Academy of Sciences and JCR databases. Enables searching, comparing journals, analyzing partition trends, and checking journal warning status across multiple years.
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides access to the Elsevier Scopus API, enabling AI assistants to search for academic papers, retrieve detailed abstracts, and look up author profiles. It facilitates bibliometric research and scholarly data analysis through natural language commands.
      5
      177 PyPI
      55
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables streamlined academic research and author disambiguation by providing AI agents with optimized access to the OpenAlex.org API. It supports searching for authors, resolving institutional affiliations, and retrieving scholarly works with detailed citation metrics.
      8
      57
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables multi-source literature search, full-text retrieval, reference analysis, and journal quality assessment across Europe PMC, PubMed, arXiv, CrossRef, OpenAlex, and EasyScholar via the MCP protocol.
      5
      22 npm
      1
      MIT