🌍 English

Overview

MCP Scholar (mcp-scholar) is a lightweight, extensible Model Context Protocol (MCP) server designed for academic researchers and AI agents. It empowers MCP-compatible clients—such as Claude Desktop, Claude Code, Cursor, and Cherry Studio—to search academic literature across multiple sources (OpenAlex primary + Google Scholar fallback), inspect paper details and references, analyze researcher profiles, and verify citations directly within conversational or agentic workflows.

✨ Key Features (v0.3.0)

• 🔎 Unified Multi-Source Search: Single search_papers tool with strategy control (exact / adaptive / hybrid). OpenAlex as primary structured source, Google Scholar as fallback.
• 📄 Deep Paper Inspection: Retrieve comprehensive metadata, full abstracts, and reference lists.
• 👨‍🔬 Scholar Profile Analytics: Parse author profiles for high-impact publications.
• ✅ BibTeX Verification: Cross-check and enrich BibTeX entries against Crossref/OpenAlex.
• 🔌 MCP Tool Annotations: Read-only tools marked with readOnlyHint / idempotentHint for safer auto-approval in clients.
• ⚡ Zero-friction Execution: uvx mcp-scholar ready.

🛠️ Available Tools

Legacy tools (scholar_search, adaptive_search, summarize_papers) remain available for compatibility but are deprecated in favor of the unified tools + host-model prompts.

🚀 Installation & Quick Start

uvx mcp-scholar

Or from source:

git clone https://github.com/renyumeng1/mcp_scholar.git
cd mcp_scholar
uv sync
uv run mcp-scholar

⚙️ Client Configuration

{
  "mcpServers": {
    "mcp-scholar": {
      "command": "uvx",
      "args": ["mcp-scholar"]
    }
  }
}

🗺️ Roadmap (beyond v0.3.0)

• Full multi-source federation (Semantic Scholar, Crossref, arXiv, DBLP)
• Preprint ↔ published deduplication
• OA PDF section-aware parsing (Methodology / Experiments)
• Citation intent analysis & bridge papers
• Zotero integration
• Local SQLite cache with TTL

🇨🇳 简体中文

项目简介

MCP Scholar（mcp-scholar）是基于 模型上下文协议（MCP） 的学术文献检索与分析服务端。它可无缝接入 Claude Desktop、Claude Code、Cursor、Cherry Studio 等客户端，支持多源学术检索、论文详情与引文溯源、学者主页分析以及 BibTeX 真实性核查。

✨ 核心特性 (v0.3.0)

• 🔎 统一多源检索：search_papers 工具支持 exact / adaptive / hybrid 策略。OpenAlex 为主力结构化源，Google Scholar 为 fallback。
• 📄 单篇详情与引文：完整元数据、摘要与参考文献。
• 👨‍🔬 学者主页分析：提取高被引代表作。
• ✅ BibTeX 核查：通过 Crossref/OpenAlex 核验并补全文献信息。
• 🔌 MCP 工具注解：只读工具带有 readOnlyHint 等标准注解，客户端可更安全地自动放行。
• ⚡ 一键启动：uvx mcp-scholar。

🛠️ 工具列表

旧工具仍保留以兼容，但推荐使用新统一工具 + 宿主模型提示词完成总结。

🚀 安装

uvx mcp-scholar

🗺️ 演进路线图

• 完整多源联邦（Semantic Scholar、Crossref、arXiv、DBLP）
• 预印本与正式版自动对齐
• OA PDF 分章节解析
• 引用意图分析
• Zotero 联动
• 本地 SQLite 缓存

📄 许可证

本项目基于 MIT License 开源。