Metadata-Version: 2.4
Name: scholar-mcp-server
Version: 0.3.0
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
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
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
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 analysis, citation graph, code-based paper recommendation.

## Quick Install (PyPI)

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

This installs the server + auto-registers to all detected AI IDEs (Antigravity, Cursor, Windsurf, Claude Code, VS Code).

## 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 → Sci-Hub → arXiv) |
| `paper_batch_download` | Batch download by DOI list |
| `paper_ai_analyze` | AI-powered full-text paper analysis (any OpenAI-compatible API) |
| `paper_recommend` | Scan workspace code → recommend related papers |
| `paper_citation_graph` | Generate Mermaid citation network visualization |
| `paper_health` | Check download source availability |

## 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 | Default |
|---|---|---|
| `AI_API_KEY` | API key for AI analysis (DeepSeek/OpenAI/etc.) | — |
| `AI_API_BASE` | API base URL | `https://api.deepseek.com` |
| `AI_MODEL` | Model name | `deepseek-chat` |
| `UNPAYWALL_EMAIL` | Email for Unpaywall API | `scholar-mcp@example.com` |

## Supported IDEs

- Antigravity (Gemini)
- Cursor
- Windsurf
- Claude Code / Claude Desktop
- VS Code (Copilot)

## License

MIT
