Skip to content
Back to search

Scholar-mcp

Local academic paper MCP server — 9-source search, multi-source download, AI analysis, translation, citation graph, code-based paper recommendation

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/45645678a--scholar-mcp/badge.svg)](/listings/45645678a--scholar-mcp)

HTML

<a href="/listings/45645678a--scholar-mcp"><img src="/api/listings/45645678a--scholar-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pip install scholar-mcp-server[all]
scholar-mcp-install --all

That's it. Restart your IDE and start using it.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Scholar MCP Server
  2. Local academic paper tool MCP server — **9-source search**, multi-source download, AI-powered analysis, citation graph, code-based paper recommendation.
  3. [![PyPI](https://img.shields.io/pypi/v/scholar-mcp-server)](https://pypi.org/project/scholar-mcp-server/)
  4. [![Python](https://img.shields.io/pypi/pyversions/scholar-mcp-server)](https://pypi.org/project/scholar-mcp-server/)
  5. [![Tests](https://github.com/45645678a/Scholar-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/45645678a/Scholar-mcp/actions/workflows/test.yml)
  6. [![License](https://img.shields.io/github/license/45645678a/Scholar-mcp)](LICENSE)
  7. ## Quick Install
  8. ```bash
  9. pip install scholar-mcp-server[all]
  10. scholar-mcp-install --all
  11. ```
  12. That's it. Restart your IDE and start using it.
  13. ## Features
  14. | Tool | Description |
  15. |---|---|
  16. | `paper_search` | 9-source concurrent search with relevance scoring (Semantic Scholar, OpenAlex, Crossref, PubMed, arXiv, CORE, Europe PMC, DOAJ, dblp) |
  17. | `paper_download` | Multi-source PDF download: Unpaywall → Publisher OA → arXiv → Sci-Hub → scidownl |
  18. | `paper_batch_download` | Batch download multiple papers by DOI list |
  19. | `paper_ai_analyze` | AI analysis — downloads PDF, extracts full text (up to 20 pages / 12k chars), sends to any OpenAI-compatible API |
  20. | `paper_recommend` | Scan your workspace code → multi-query auto-recommend related papers |
  21. | `paper_citation_graph` | Generate Mermaid citation/reference network visualization |
  22. | `paper_health` | Check download source availability |
  23. ### Search Quality
  24. Search results are ranked by a **4-factor composite score**:
  25. | Factor | Weight | Description |
  26. |---|---|---|
  27. | Query relevance | 0–40 | Title + abstract term matching |
  28. | Citation impact | 0–30 | Log-scaled citation count |
  29. | Source quality | 0–10 | Data source reliability weighting |
  30. | Year recency | 0–15 | Boost for recent publications |
  31. Deduplication uses **DOI matching + Jaccard title similarity** (≥0.7 threshold) across all 9 sources. Each source connector has built-in **retry with exponential backoff**.
  32. ## AI Analysis
  33. `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.
  34. ## Alternative Install (Git Clone)
  35. ```bash
  36. git clone https://github.com/45645678a/Scholar-mcp.git
  37. cd Scholar-mcp
  38. pip install -r requirements.txt
  39. python install.py --all
  40. ```
  41. ## Environment Variables
  42. | Variable | Description | Required |
  43. |---|---|---|
  44. | `AI_API_KEY` | API key for AI analysis | For `paper_ai_analyze` |
  45. | `AI_API_BASE` | API base URL (any OpenAI-compatible endpoint) | Optional (default: `https://api.deepseek.com`) |
  46. | `AI_MODEL` | Model name | Optional (default: `deepseek-chat`) |
  47. | `UNPAYWALL_EMAIL` | Email for Unpaywall API | Optional |
  48. ## Supported IDEs
  49. - **Antigravity** (Gemini)
  50. - **Cursor**
  51. - **Windsurf**
  52. - **Claude Code** / Claude Desktop
  53. - **VS Code** (Copilot)
  54. ## Search Sources (9)
  55. All free, no API keys required:
  56. | Source | Coverage |
  57. |---|---|
  58. | Semantic Scholar | Broad academic (primary) |
  59. | OpenAlex | 250M+ works, global |
  60. | Crossref | DOI metadata |
  61. | PubMed | Biomedical |
  62. | arXiv | Physics, CS, Math |
  63. | CORE | Open Access aggregator |
  64. | Europe PMC | European biomedical |
  65. | DOAJ | Open Access journals |
  66. | dblp | Computer Science |
  67. ## Development
  68. ```bash
  69. pip install .[all] pytest
  70. pytest tests/ -v
  71. ```
  72. 40 tests covering search dedup, download chain, keyword extraction, and connector mocking.
  73. ## ⚠️ Disclaimer
  74. 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.
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.