JackKuo666/Google-Scholar-MCP-Server: A MCP Server for Google Scholar: 🔍 Enable AI assistants to search and access Google Scholar papers through a simple MCP interface.

Google Scholar MCP 服务器#

🔍 通过简单的 MCP 界面，使 AI 助手能够搜索和访问 Google Scholar 论文。

Google Scholar MCP 服务器通过模型上下文协议 (MCP) 在 AI 助手和 Google Scholar 之间架起桥梁。它允许 AI 模型以编程方式搜索学术论文并访问其内容。

✨ 核心功能#

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

🚀 快速入门#

手动安装#

通过 Smithery 安装#

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

克劳德

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

光标

将以下内容粘贴到“设置”→“光标设置”→“MCP”→“添加新服务器”中：

Mac/Linux

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

风帆冲浪

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

C 线#

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

克隆仓库：

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

安装所需的依赖项：
```
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

📊 Usage#

Start the MCP server:

python google_scholar_server.py

Once the server is running, you can use the provided MCP tools in your AI assistant or application. Here are some examples of how to use the tools:

Example 1: Search for papers using keywords#

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

Example 2: Perform an advanced search#

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

Example 3: Get author information#

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

These examples demonstrate how to use the three main tools provided by the Google Scholar MCP Server. Adjust the parameters as needed for your specific use case.

Usage with Claude Desktop#

Add this configuration to your claude_desktop_config.json:

(Mac OS)

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

(Windows version):

{
  "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": []
    }
  }
}

Using with 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 Tools#

The Google Scholar MCP Server provides the following tools:

search_google_scholar_key_words#

Search for articles on Google Scholar using key words.

Parameters:

query (str): Search query string
num_results (int, optional): Number of results to return (default: 5)

Returns: List of dictionaries containing article information

search_google_scholar_advanced#

Perform an advanced search for articles on Google Scholar.

Parameters:

query (str): General search query
author (str, optional): Author name
year_range (tuple, optional): Tuple containing (start_year, end_year)
num_results (int, optional): Number of results to return (default: 5)

Returns: List of dictionaries containing article information

get_author_info#

Get detailed information about an author from Google Scholar.

Parameters:

author_name (str): Name of the author to search for

Returns: Dictionary containing author information

📁 Project Structure#

google_scholar_server.py: The main MCP server implementation using FastMCP
google_scholar_web_search.py: Contains the web scraping logic for searching Google Scholar

🔧 Dependencies#

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

You can install the required dependencies using:

pip install -r requirements.txt

🤝 Contributing#

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License#

This project is licensed under the MIT License.

⚠️ Disclaimer#

This tool is for research purposes only. Please respect Google Scholar's terms of service and use this tool responsibly.