Scholarscope MCP

🚀 ScholarScope MCP

ScholarScope MCP is an academic MCP server that leverages FastMCP to offer robust support for academic research, integrating with OpenAlex API for comprehensive literature search and retrieval.

🚀 Quick Start

The ScholarScope MCP Server is a custom Model Context Protocol server. It's powered by FastMCP and designed for high - performance academic research. It integrates with the OpenAlex API to search for papers, authors, and institutions, retrieve citations, and fetch full - text papers using Jina when available.

✨ Features

• 🔍 Search papers by keyword, title, author, or institution
• 📊 Sort results by relevance, citations, or publication date
• 📚 Retrieve related works and citations for any paper
• 📄 Fetch full text from preferred sources when available
• ⚡ Built with FastMCP for fast startup and modular tools

📦 Installation

1. Clone the repository

   git clone https://github.com/ErikNguyen20/ScholarScope-MCP.git
   cd ScholarScope-MCP
   

2. Install uv (if you don’t already have it)

   pip install uv
   

3. Install dependencies

   uv sync
   

4. Set up environment variables Create a .env file in the project root:

   OPENALEX_MAILTO=your_email@example.com
   

💻 Usage Examples

Run with MCP Inspector

You can use the official MCP Inspector to test your server locally:

npx @modelcontextprotocol/inspector uv run \
  --directory "/path/to/mcp_server" \
  --with fastmcp \
  fastmcp run src/server.py

⚠️ Important Note

Replace /path/to/mcp_server with the path to your local project root.

Connect to Claude Desktop

1. Open your Claude Desktop configuration file (usually claude_desktop_config.json).
2. Add your MCP server configuration:

{
  "mcpServers": {
    "Tool Example": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/mcp_server",
        "fastmcp",
        "run",
        "src/server.py"
      ]
    }
  }
}

⚠️ Important Note

Ensure the /path/to/mcp_server matches your local directory structure. Restart Claude Desktop after updating the config.