📚 Academic MCP

English | 中文

🔬 academic-mcp is a Python-based MCP server that enables users to search, download, and read academic papers from various platforms. It provides three main tools:

• 🔎 paper_search: Search papers across multiple academic databases

• 📥 paper_download: Download paper PDFs, return paths of downloaded files

• 📖 paper_read: Extract and read text content from papers

📑 Table of Contents

• 🎬 Screenshot

• 📝 TODO

• ✨ Features

• 📦 Installation

  • ⚡ Quick Start

  • 🛠️ For Development

• 🚀 Usage

  • 🔎 Search Papers

  • 📥 Download Papers

  • 📖 Read Papers

  • ⚙️ Environment Variables

• 🤝 Contributing

• 📄 License

✨ Features

• 🌐 Multi-Source Support: Search and download papers from 19+ academic databases including arXiv, PubMed, PubMed Central, bioRxiv, medRxiv, Google Scholar, IACR ePrint Archive, Semantic Scholar, CrossRef, Science Direct, Springer, IEEE Xplore, Scopus, CORE, and more.

• 🎯 Unified Interface: All platforms accessible through consistent paper_search, paper_download, and paper_read tools.

• 📊 Standardized Output: Papers are returned in a consistent dictionary format via the Paper class.

• ⚡ Asynchronous Operations: Efficiently handles concurrent searches and downloads using httpx and async/await.

• 🔌 MCP Integration: Compatible with MCP clients for LLM context enhancement.

• 🧩 Extensible Design: Easily add new academic platforms by extending the sources module.

🎬 Screenshot

📝 Supported Academic Platforms

✅ Fully Implemented (19 sources)

Free & Open Access:

• arXiv - Pre-print repository for physics, mathematics, CS, and more

• PubMed - Biomedical literature database

• PubMed Central (PMC) - Free full-text biomedical and life sciences articles

• bioRxiv - Pre-print server for biology

• medRxiv - Pre-print server for health sciences

• Semantic Scholar - AI-powered research tool

• CrossRef - DOI registration agency and metadata provider

• Google Scholar - Academic search engine

• IACR ePrint Archive - Cryptology pre-prints

• CORE - Open access research papers aggregator

API Key Required:

• Science Direct - Elsevier's full-text scientific database (requires Elsevier API key)

• Springer Link - Springer's scientific publications (requires Springer API key)

• IEEE Xplore - IEEE's digital library (requires IEEE API key)

• Scopus - Elsevier's abstract and citation database (requires Scopus API key)

Institutional Access Required:

• ACM Digital Library - ACM's computing literature (no public API)

• Web of Science - Clarivate's citation database (requires subscription)

• JSTOR - Digital library of academic journals (no public API)

• ResearchGate - Academic social network (no official API)

Retired Services:

• Microsoft Academic - Service retired December 31, 2021 (placeholder implementation)

📦 Installation

academic-mcp can be installed using uv or pip. Below are detailed installation guides for different scenarios.

⚡ Quick Install

Install the package:

Start the MCP server:

🔧 MCP Client Configuration

Choose your MCP client and follow the configuration steps:

Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

Location: ~/.config/claude/config.json

Configuration:

Verify Installation:

Location: VS Code Settings → Extensions → Cline → MCP Settings

Method 1: Through VS Code Settings UI

1. Open VS Code Settings (Cmd/Ctrl + ,)

2. Search for "Cline MCP"

3. Click "Edit in settings.json"

4. Add the configuration:

Method 2: Direct settings.json Edit

Edit ~/.config/Code/User/settings.json (Linux/macOS) or %APPDATA%\Code\User\settings.json (Windows):

Location: ~/.config/zed/settings.json

Configuration:

For other MCP clients, use the standard MCP server configuration:

Server Command:

Environment Variables:

• SEMANTIC_SCHOLAR_API_KEY: Optional API key for Semantic Scholar

• SCIENCEDIRECT_API_KEY: Optional API key for Science Direct

• SPRINGER_API_KEY: Optional API key for Springer Link

• IEEE_API_KEY: Optional API key for IEEE Xplore

• SCOPUS_API_KEY: Optional API key for Scopus

• CORE_API_KEY: Optional API key for CORE

• ACADEMIC_MCP_DOWNLOAD_PATH: Download directory (default: ./downloads)

Server Capabilities:

• Tools: paper_search, paper_download, paper_read

• Transport: stdio

• Protocol: MCP 1.0

⚙️ Environment Variables

API Keys (optional - only for premium services):

• SEMANTIC_SCHOLAR_API_KEY: Semantic Scholar (Get API Key)

• SCIENCEDIRECT_API_KEY: Elsevier Science Direct (Get API Key)

• SPRINGER_API_KEY: Springer Nature (Get API Key)

• IEEE_API_KEY: IEEE Xplore (Get API Key)

• SCOPUS_API_KEY: Elsevier Scopus (Get API Key)

• CORE_API_KEY: CORE aggregator (Get API Key)

• WOS_API_KEY: Web of Science (requires institutional subscription)

General Settings:

• ACADEMIC_MCP_DOWNLOAD_PATH: Directory for downloaded PDFs (default: ./downloads)

Source Control:

• ACADEMIC_MCP_ENABLED_SOURCES: Comma-separated list to enable specific sources (whitelist)

• ACADEMIC_MCP_DISABLED_SOURCES: Comma-separated list to disable specific sources (blacklist)

• If both are set, ACADEMIC_MCP_ENABLED_SOURCES takes precedence

• If neither is set, all 18 sources are enabled by default

Available Source Names (18 total):

🚀 Usage

Once configured, academic-mcp provides three main tools accessible through Claude Desktop or any MCP-compatible client.

1. Search Papers (paper_search)

Search for academic papers across multiple sources:

Basic Search Examples:

Multi-Platform Search:

Premium Sources (require API keys):

Search All Platforms:

2. Download Papers (paper_download)

Download paper PDFs using their identifiers:

Note: Premium sources (IEEE, Springer, Science Direct, Scopus) require institutional access or subscriptions for PDF downloads.

3. Read Papers (paper_read)

Extract and read text content from papers:

🛠️ For Development

For developers who want to modify the code or contribute:

1. Setup Environment:

   # Install uv if not installed curl -LsSf https://astral.sh/uv/install.sh | sh # Clone repository git clone https://github.com/LinXueyuanStdio/academic-mcp.git cd academic-mcp # Create and activate virtual environment uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

2. Install Dependencies:

   # Install dependencies (recommended) uv pip install -e . # Add development dependencies (optional) uv pip install pytest flake8

🤝 Contributing

We welcome contributions! Here's how to get started:

1. Fork the Repository: Click "Fork" on GitHub.

2. Clone and Set Up:

   git clone https://github.com/yourusername/academic-mcp.git cd academic-mcp uv pip install -e . # Install in development mode

3. Make Changes:

   • Add new platforms in academic_mcp/sources/.

   • Update tests in tests/.

4. Submit a Pull Request: Push changes and create a PR on GitHub.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Happy researching with academic-mcp! If you encounter issues, open a GitHub issue.