Scholar MCP Server

A Model Context Protocol (MCP) server providing structured access to scientific literature databases. It serves as a unified interface for Scopus, OpenAlex, and Unpaywall, enabling AI agents to perform systematic paper discovery, author disambiguation, citation lineage tracking, and multimodal Content extraction.

Core Capabilities

• Unified Literature Search

  • Scopus Integration — Targeted metadata retrieval via advanced Boolean syntax (requires API key).
  • OpenAlex Integration — Broad search across 250M+ works with abstract reconstruction.
  • Unpaywall Resolution — DOI-to-PDF cross-referencing across global Open Access repositories.

• Author Identification & Metrics

  • Instant author disambiguation and ID resolution via OpenAlex autocomplete.
  • Comprehensive profiles: H-index, i10-index, institutional affiliation history, and ORCID linkage.
  • Precision metrics from Elsevier (Scopus) for verified publication counts.

• Citation Lineage Tracking

  • Map research evolution through forward citations (citing works) and backward references (cited works).

• Structured & Multimodal Extraction

  • Text Extraction — Layout-aware parsing of OA PDFs using PyMuPDF.
  • Vision Rendering — Page-by-page PNG rendering for LLM-based analysis of charts, tables, and equations.
  • HTML Fallbacks — Extraction from web-based research resources via BeautifulSoup.

• Topic Mapping & Field Analysis

  • Concepts and domain hierarchy discovery to map research landscapes.
  • Batch metadata retrieval for high-throughput literature processing (up to 50 DOIs/request).

• Access Management & Fallbacks

  • Automated detection of closed-access content with human-in-the-loop instructions for manual uploads.

Architecture

graph TD
    A[LLM Agent] -->|MCP Protocol| B(Scholar MCP Server)
    B --> C{Database Router}
    C -->|Primary| D[Scopus API]
    C -->|Fallback| E[OpenAlex API]
    C -->|DOI Resolver| F[Unpaywall API]
    C -->|Citations| P[CrossRef API]
    
    D --> G{Access Check}
    E --> G
    F --> G
    P --> G
    
    G -->|Open Access| H[PDF Buffer Download]
    G -->|Closed Access| I[Human-in-the-Loop Prompt]
    H --> J[PyMuPDF Text Extractor]
    H --> K[PyMuPDF Vision Renderer]
    J --> L[Return Context to LLM]
    K --> L
    I --> L
    B --> M{Author Router}
    M -->|Profile| N[OpenAlex Authors API]
    M -->|Metrics| O[Scopus Author API]
    N --> L
    O --> L

Installation

Quick Start (via PyPI)

The fastest way to use the server is directly via PyPI:

pip install scholar-academic-mcp

Manual Setup (for Development)

# Clone the repository
git clone https://github.com/mlintangmz2765/Scholar-MCP.git
cd Scholar-MCP

# Setup virtual environment
python -m venv venv
.\venv\Scripts\activate  # Windows
source venv/bin/activate # Unix

# Install in editable mode
pip install -e .

Environment Variables

... View full README on GitHub