Skip to main content

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

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

Metadata

Release files for easyscholar-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for easyscholar-mcp 0.2.0
File Size Uploaded Provenance Actions
easyscholar_mcp-0.2.0.tar.gz 9.5 kB With provenance Details for easyscholar_mcp-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for easyscholar-mcp 0.2.0
File Interpreter ABI Platform Actions
easyscholar_mcp-0.2.0-py3-none-any.whl Python 3 none any Details for easyscholar_mcp-0.2.0-py3-none-any.whl

Total release size: 18.4 kB

Release files / easyscholar_mcp-0.2.0.tar.gz

Download URL easyscholar_mcp-0.2.0.tar.gz
Size 9.5 kB
Tags Source
SHA-256 checksum
How to use checksums
e47809e1a48e64133876fd92d46ce3a2161a8aa75550870b990009191f72830b
BLAKE2b-256 checksum
How to use checksums
86108cef757676788420b015e9d97ac895121c02e5c1ffc364bba43815224f9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / easyscholar_mcp-0.2.0-py3-none-any.whl

Download URL easyscholar_mcp-0.2.0-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fede0d5b63c8aee28a244ff2807033d08d289ef1b65a58f3ded8346a385891b1
BLAKE2b-256 checksum
How to use checksums
aa7d2d4f9d2d17433a1b1f326fa871d56db879f6c0f8118c13395db7182820e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for easyscholar-mcp 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for easyscholar_mcp-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page