Google Scholar MCP Server

Google Scholar MCP 服务

🔍 通过简单的 MCP 接口，让 AI 助手能够搜索和访问 Google Scholar 论文。

Google Scholar MCP 服务通过模型上下文协议（MCP），在 AI 助手与 Google Scholar 之间搭建桥梁。它支持 AI 模型以编程方式搜索学术论文并访问论文内容。

✨ 核心功能

• 🔎 论文搜索：使用自定义搜索字符串或高级搜索参数查询 Google Scholar 论文 ✅
• 🚀 高效检索：快速访问论文元数据 ✅
• 👤 作者信息：获取作者的详细信息 ✅
• 📊 研究支持：助力学术研究与分析 ✅

🚀 快速开始

手动安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 google-scholar Server：

claude

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client claude --config "{}"

Cursor

将以下内容粘贴到 Settings → Cursor Settings → MCP → Add new server：

• Mac/Linux

npx -y @smithery/cli@latest run @JackKuo666/google-scholar-mcp-server --client cursor --config "{}" 

Windsurf

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client windsurf --config "{}"

CLine

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client cline --config "{}"

1. 克隆仓库：

   git clone https://github.com/JackKuo666/google-scholar-MCP-Server.git
   cd google-scholar-MCP-Server
   

2. 安装所需依赖：

   pip install -r requirements.txt
   

开发环境：

# Clone and set up development environment
git clone https://github.com/JackKuo666/Google-Scholar-MCP-Server.git
cd Google-Scholar-MCP-Server

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

# Install dependencies
pip install -r requirements.txt

📊 使用方法

启动 MCP 服务：

python google_scholar_server.py

服务启动后，你可以在 AI 助手或应用程序中使用提供的 MCP 工具。以下是一些工具使用示例：

示例 1：使用关键词搜索论文

result = await mcp.use_tool("search_google_scholar_key_words", {
    "query": "artificial intelligence ethics",
    "num_results": 5
})
print(result)

示例 2：执行高级搜索

result = await mcp.use_tool("search_google_scholar_advanced", {
    "query": "machine learning",
    "author": "Hinton",
    "year_range": [2020, 2023],
    "num_results": 3
})
print(result)

示例 3：获取作者信息

result = await mcp.use_tool("get_author_info", {
    "author_name": "Geoffrey Hinton"
})
print(result)

这些示例展示了如何使用 Google Scholar MCP 服务提供的三个主要工具。请根据具体使用场景调整参数。

在 Claude Desktop 中使用

将此配置添加到 claude_desktop_config.json：

（Mac OS）

{
  "mcpServers": {
    "google-scholar": {
      "command": "python",
      "args": ["-m", "google_scholar_mcp_server"]
      }
  }
}

（Windows 版本）：

{
  "mcpServers": {
    "google-scholar": {
      "command": "C:\\Users\\YOUR\\PATH\\miniconda3\\envs\\mcp_server\\python.exe",
      "args": [
        "D:\\code\\YOUR\\PATH\\Google-Scholar-MCP-Server\\google_scholar_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

在 Cline 中使用

{
  "mcpServers": {
    "google-scholar": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/.venv/bin/activate && python /home/YOUR/PATH/google_scholar_mcp_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

🛠 MCP 工具

Google Scholar MCP 服务提供以下工具：

search_google_scholar_key_words

使用关键词在 Google Scholar 上搜索文章。

参数：

• query（str）：搜索查询字符串
• num_results（int，可选）：返回的结果数量（默认值：5）

**返回值：**包含文章信息的字典列表

search_google_scholar_advanced

在 Google Scholar 上执行高级文章搜索。

参数：

• query（str）：常规搜索查询
• author（str，可选）：作者姓名
• year_range（tuple，可选）：包含（start_year，end_year）的元组
• num_results（int，可选）：返回的结果数量（默认值：5）

**返回值：**包含文章信息的字典列表

get_author_info

从 Google Scholar 获取作者的详细信息。

参数：

• author_name（str）：要搜索的作者姓名

**返回值：**包含作者信息的字典

📁 项目结构

• google_scholar_server.py：使用 FastMCP 实现的 MCP 服务主程序
• google_scholar_web_search.py：包含用于搜索 Google Scholar 的网页抓取逻辑

🔧 依赖项

• Python 3.10+
• mcp[cli]>=1.4.1
• scholarly>=1.7.0
• asyncio>=3.4.3

你可以使用以下命令安装所需依赖：

pip install -r requirements.txt

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。

📄 许可证

本项目采用 MIT 许可证。

⚠️ 免责声明

此工具仅供研究使用。请遵守 Google Scholar 的服务条款，并负责任地使用此工具。