Scholar MCP Server
Local academic paper tool MCP server — 9-source search, multi-source download, AI-powered analysis, citation graph, code-based paper recommendation.
Quick Install
pip install scholar-mcp-server[all]
scholar-mcp-install --all
That's it. Restart your IDE and start using it.
Features
| Tool | Description |
|---|---|
paper_search |
9-source concurrent search with relevance scoring (Semantic Scholar, OpenAlex, Crossref, PubMed, arXiv, CORE, Europe PMC, DOAJ, dblp) |
paper_download |
Multi-source PDF download: Unpaywall → Publisher OA → arXiv → Sci-Hub → scidownl |
paper_batch_download |
Batch download multiple papers by DOI list |
paper_ai_analyze |
AI analysis — downloads PDF, extracts full text (up to 20 pages / 12k chars), sends to any OpenAI-compatible API |
paper_recommend |
Scan your workspace code → multi-query auto-recommend related papers |
paper_citation_graph |
Generate Mermaid citation/reference network visualization |
paper_health |
Check download source availability |
Search Quality
Search results are ranked by a 4-factor composite score:
| Factor | Weight | Description |
|---|---|---|
| Query relevance | 0–40 | Title + abstract term matching |
| Citation impact | 0–30 | Log-scaled citation count |
| Source quality | 0–10 | Data source reliability weighting |
| Year recency | 0–15 | Boost for recent publications |
Deduplication uses DOI matching + Jaccard title similarity (≥0.7 threshold) across all 9 sources. Each source connector has built-in retry with exponential backoff.
AI Analysis
paper_ai_analyze works with any OpenAI-compatible API. Set AI_API_BASE, AI_API_KEY, and AI_MODEL to point to your preferred provider.
Alternative Install (Git Clone)
git clone https://github.com/45645678a/scholar-mcp.git
cd scholar-mcp
pip install -r requirements.txt
python install.py --all
Environment Variables
| Variable | Description | Required |
|---|---|---|
AI_API_KEY |
API key for AI analysis | For paper_ai_analyze |
AI_API_BASE |
API base URL (any OpenAI-compatible endpoint) | Optional (default: https://api.deepseek.com) |
AI_MODEL |
Model name | Optional (default: deepseek-chat) |
UNPAYWALL_EMAIL |
Email for Unpaywall API | Optional |
Supported IDEs
- Antigravity (Gemini)
- Cursor
- Windsurf
- Claude Code / Claude Desktop
- VS Code (Copilot)
Search Sources (9)
All free, no API keys required:
| Source | Coverage |
|---|---|
| Semantic Scholar | Broad academic (primary) |
| OpenAlex | 250M+ works, global |
| Crossref | DOI metadata |
| PubMed | Biomedical |
| arXiv | Physics, CS, Math |
| CORE | Open Access aggregator |
| Europe PMC | European biomedical |
| DOAJ | Open Access journals |
| dblp | Computer Science |
Development
pip install .[all] pytest
pytest tests/ -v
40 tests covering search dedup, download chain, keyword extraction, and connector mocking.
⚠️ Disclaimer
This tool includes optional Sci-Hub integration for personal academic use. Sci-Hub may be illegal in some jurisdictions. Users are solely responsible for ensuring compliance with local laws and institutional policies. The authors do not endorse copyright infringement. If you are in a compliance-sensitive environment (university, company, lab), consult your institution's policy before using the Sci-Hub download source.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for scholar-mcp-server 0.5.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 |
|---|---|---|---|---|
| scholar_mcp_server-0.5.0.tar.gz | 53.4 kB | Without provenance | Details for scholar_mcp_server-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| scholar_mcp_server-0.5.0-py3-none-any.whl | Python 3 | none | any | Details for scholar_mcp_server-0.5.0-py3-none-any.whl |
Total release size: 99.4 kB
Release files / scholar_mcp_server-0.5.0.tar.gz
| Download URL | scholar_mcp_server-0.5.0.tar.gz |
|---|---|
| Size | 53.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
97766dc89c8a4bf6d2a932ab243a9030d1c772afba6ba92d3d7e7583e1d5d115
|
|
BLAKE2b-256 checksum How to use checksums |
5ebd61d4c260223c4d7f5c2844282e9793d5f98210905b63c8e1d65f12bbfff3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / scholar_mcp_server-0.5.0-py3-none-any.whl
| Download URL | scholar_mcp_server-0.5.0-py3-none-any.whl |
|---|---|
| Size | 46.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9afc0a938cbb0bffbb129c84e06f7a54899af7654a5b74554152e72cb1ae1229
|
|
BLAKE2b-256 checksum How to use checksums |
4066549e877249b268171ac34bce9aa6918e00b431f79a5ea49b860b63400b60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for scholar-mcp-server 0.5.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.
