Mcp Scholar

---

🌍 英文

概述

MCP Scholar（mcp-scholar）是一款轻量、可扩展的模型上下文协议（MCP）服务，专为学术研究者和 AI Agent 设计。它支持 MCP 的客户端（例如 Claude Desktop、Claude Code、Cursor 和 Cherry Studio）可在对话式或 Agent 工作流中跨多个来源检索学术文献（主要使用 OpenAlex；OpenAlex 数据较少时使用 Semantic Scholar）、查看论文详情和参考文献、分析研究者主页，并核验引文。

✨ 核心特性（v0.4.1）

• 🔎 统一多源检索：通过单个 search_papers 工具进行搜索，并控制策略（exact / adaptive / hybrid）。主要使用 OpenAlex；OpenAlex 返回结果过少时使用 Semantic Scholar。
• 📄 深入查看论文：获取完整元数据、完整摘要和参考文献列表。
• 👨‍🔬 学者主页分析：解析作者主页，查找高影响力论文。
• ✅ BibTeX 核验：对照 Crossref/OpenAlex 检查并补全 BibTeX 条目。
• 🔌 MCP 工具注解：只读工具标记了 readOnlyHint / idempotentHint，方便客户端更安全地自动批准。
• ⚡ 零摩擦运行：可直接使用 uvx mcp-scholar。

🛠️ 可用工具

工具名称	描述	关键参数
search_papers	统一文献检索（取代旧版 scholar_search + adaptive_search）	keywords、count、strategy（exact|adaptive|hybrid）、sort_by、year_start、year_end
paper_detail	获取详细元数据和完整摘要	paper_id
paper_references	提取参考文献 / 引用该论文的论文	paper_id、count
profile_papers	分析作者主页和代表论文	profile_url / user_id、count
verify_bibtex	核验并补全 BibTeX 条目	bibtex
health_check	检查服务和上游服务的可用性	无

旧版工具（scholar_search、adaptive_search、summarize_papers）仍可使用以保持兼容，但已弃用，建议改用统一工具 + 宿主模型提示词。

🚀 安装与快速开始

uvx mcp-scholar

或从源码安装：

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

⚙️ 客户端配置

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

🗺️ 路线图（v0.3.0 之后）

• 完整的多源联合检索（Semantic Scholar、Crossref、arXiv、DBLP）
• 预印本 ↔ 已发表论文去重
• 可感知开放获取 PDF 章节的解析（方法 / 实验）
• 引文意图分析与桥接论文
• Zotero 集成
• 带 TTL 的本地 SQLite 缓存

---

🇨🇳 简体中文

项目简介

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

✨ 核心特性（v0.4.1）

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

🛠️ 工具列表

工具名称	功能说明	核心参数
search_papers	统一学术检索（替代旧的 scholar_search + adaptive_search）	keywords, count, strategy, sort_by, year_start, year_end
paper_detail	获取单篇论文详细信息	paper_id
paper_references	获取引用/参考文献	paper_id, count
profile_papers	分析学者主页高引论文	profile_url, count
verify_bibtex	核验并补全 BibTeX	bibtex
health_check	健康检查	无

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

🚀 安装

uvx mcp-scholar

🗺️ 演进路线图

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

---

📄 许可证

本项目基于 MIT License 开源。