Metadata-Version: 2.4
Name: scholar-mcp-server
Version: 0.3.2
Summary: Local academic paper MCP server — 9-source search, multi-source download, AI analysis, citation graph, code-based paper recommendation
Author: 45645678a
License: MIT
Project-URL: Homepage, https://github.com/45645678a/scholar-mcp
Project-URL: Repository, https://github.com/45645678a/scholar-mcp
Keywords: mcp,academic,paper,scholar,download,sci-hub,arxiv,ai,semantic-scholar,openalex,research,citation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Text Processing :: General
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.31.0
Provides-Extra: pdf
Requires-Dist: pymupdf>=1.23.0; extra == "pdf"
Provides-Extra: pdf-alt
Requires-Dist: pdfplumber>=0.10.0; extra == "pdf-alt"
Provides-Extra: scihub
Requires-Dist: scidownl>=1.0.2; extra == "scihub"
Provides-Extra: all
Requires-Dist: pymupdf>=1.23.0; extra == "all"
Requires-Dist: scidownl>=1.0.2; extra == "all"
Dynamic: license-file

# Scholar MCP Server

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

[![PyPI](https://img.shields.io/pypi/v/scholar-mcp-server)](https://pypi.org/project/scholar-mcp-server/)
[![Python](https://img.shields.io/pypi/pyversions/scholar-mcp-server)](https://pypi.org/project/scholar-mcp-server/)
[![License](https://img.shields.io/github/license/45645678a/scholar-mcp)](LICENSE)

## Quick Install

```bash
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: 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 → auto-recommend related papers |
| `paper_citation_graph` | Generate Mermaid citation/reference network visualization |
| `paper_health` | Check download source availability |

## 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)

```bash
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 |

## ⚠️ 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
