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
&andand, drops punctuation, and turns:into-. When one of them matches,matched_nameshows which. - If nothing matches,
foundisfalseand the result lists the spellings intriedplus ahint. 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
- Get a secret key from your easyScholar account (Personal Center → Open API).
- 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.