Skip to main content

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 terms
  • sources (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.00001 or arxiv:2301.00001
  • pubmed_id — PubMed ID (PMID), e.g. 36383508
  • doi — 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 ✓ PDF
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

mcp_scholaris-0.1.4.tar.gz (17.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_scholaris-0.1.4-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

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

Hashes for mcp_scholaris-0.1.4.tar.gz
Algorithm Hash digest
SHA256 ffece9d27bfa5ad1a02a56f660f00eaac2a7115b48ce749d155bfeed3fb517cd
MD5 05f5205889cea871a079c56969fc9f7f
BLAKE2b-256 ff833da15033503410fc7a996a401cd32ca657570ac30f841b41b50ae761deb5

See more details on using hashes here.

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

Hashes for mcp_scholaris-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 99295dd0f014b9e879f27512abaedc8333868b717f3eba78db0de68f60e523e2
MD5 b242956a75cb5ab05fbc31922203c9e7
BLAKE2b-256 a32500371430f4d7fbbbef42f890e5b87984ca786f39122847ab7d652fb1138d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page