mcp-name: io.github.penny4nonsense/mcp-scholaris - Academic paper search and retrieval via arXiv, Semantic Scholar, PubMed, Unpaywall.
Project description
mcp-scholaris
An MCP server for retrieving academic papers from open access sources. Provides search across arXiv, Semantic Scholar, and PubMed, with full text retrieval via arXiv PDFs, PubMed Central (BioC API), and Unpaywall. No paywalls, no grey area — legitimate open access only.
Installation
pip install mcp-scholaris
Tools
search_papers
Search for academic papers by topic, author, or keyword.
Parameters:
query(required) — search termssources(optional) — list of sources to search:arxiv,semantic_scholar,pubmed. Defaults to all three.max_results(optional) — maximum results per source. Defaults to 5.
fetch_paper
Fetch the full text of a paper. Tries open access sources in order: arXiv → PubMed Central → Unpaywall. Provide at least one identifier.
Parameters:
arxiv_id— e.g.2301.00001orarxiv:2301.00001pubmed_id— PubMed ID (PMID), e.g.36383508doi— e.g.10.1371/journal.pone.0276755
Configuration
Semantic Scholar works without an API key but is rate-limited. For higher limits, create a .env file in your working directory:
SEMANTIC_SCHOLAR_API_KEY=your_key_here
API keys are free at semanticscholar.org.
Usage with an MCP client
Add to your MCP client configuration:
{
"mcpServers": {
"scholaris": {
"command": "scholaris"
}
}
}
Or run directly:
scholaris
The server communicates over stdio using the MCP protocol (JSON-RPC 2.0).
Sources
| Source | Search | Full Text |
|---|---|---|
| arXiv | ✓ | |
| Semantic Scholar | ✓ | ✓ when OA PDF available |
| PubMed | ✓ | ✓ via BioC API (PMC articles) |
| Unpaywall | — | ✓ for any DOI with OA version |
License
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_scholaris-0.1.4.tar.gz.
File metadata
- Download URL: mcp_scholaris-0.1.4.tar.gz
- Upload date:
- Size: 17.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ffece9d27bfa5ad1a02a56f660f00eaac2a7115b48ce749d155bfeed3fb517cd
|
|
| MD5 |
05f5205889cea871a079c56969fc9f7f
|
|
| BLAKE2b-256 |
ff833da15033503410fc7a996a401cd32ca657570ac30f841b41b50ae761deb5
|
File details
Details for the file mcp_scholaris-0.1.4-py3-none-any.whl.
File metadata
- Download URL: mcp_scholaris-0.1.4-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
99295dd0f014b9e879f27512abaedc8333868b717f3eba78db0de68f60e523e2
|
|
| MD5 |
b242956a75cb5ab05fbc31922203c9e7
|
|
| BLAKE2b-256 |
a32500371430f4d7fbbbef42f890e5b87984ca786f39122847ab7d652fb1138d
|