Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jackkuo666--google-scholar-mcp-server/badge.svg)](/listings/jackkuo666--google-scholar-mcp-server)

HTML

<a href="/listings/jackkuo666--google-scholar-mcp-server"><img src="/api/listings/jackkuo666--google-scholar-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing Manually

Installing via Smithery

To install google-scholar Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@JackKuo666/google-scholar-mcp-server):

claude

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

Cursor

Paste the following into 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. Clone the repository:

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

2. Install the required dependencies:

   pip install -r requirements.txt

For development:

# 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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Google Scholar MCP Server
  2. [![smithery badge](https://smithery.ai/badge/@JackKuo666/google-scholar-mcp-server)](https://smithery.ai/server/@JackKuo666/google-scholar-mcp-server)
  3. πŸ” Enable AI assistants to search and access Google Scholar papers through a simple MCP interface.
  4. The Google Scholar MCP Server provides a bridge between AI assistants and Google Scholar through the Model Context Protocol (MCP). It allows AI models to search for academic papers and access their content in a programmatic way.
  5. ## ✨ Core Features
  6. - πŸ”Ž Paper Search: Query Google Scholar papers with custom search strings or advanced search parameters βœ…
  7. - πŸš€ Efficient Retrieval: Fast access to paper metadata βœ…
  8. - πŸ‘€ Author Information: Retrieve detailed information about authors βœ…
  9. - πŸ“Š Research Support: Facilitate academic research and analysis βœ…
  10. ## πŸš€ Quick Start
  11. ### Installing Manually
  12. ### Installing via Smithery
  13. To install google-scholar Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@JackKuo666/google-scholar-mcp-server):
  14. #### claude
  15. ```sh
  16. npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client claude --config "{}"
  17. ```
  18. #### Cursor
  19. Paste the following into Settings β†’ Cursor Settings β†’ MCP β†’ Add new server:
  20. - Mac/Linux
  21. ```s
  22. npx -y @smithery/cli@latest run @JackKuo666/google-scholar-mcp-server --client cursor --config "{}"
  23. ```
  24. #### Windsurf
  25. ```sh
  26. npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client windsurf --config "{}"
  27. ```
  28. ### CLine
  29. ```sh
  30. npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client cline --config "{}"
  31. ```
  32. 1. Clone the repository:
  33. ```
  34. git clone https://github.com/JackKuo666/google-scholar-MCP-Server.git
  35. cd google-scholar-MCP-Server
  36. ```
  37. 2. Install the required dependencies:
  38. ```
  39. pip install -r requirements.txt
  40. ```
  41. For development:
  42. ```bash
  43. # Clone and set up development environment
  44. git clone https://github.com/JackKuo666/Google-Scholar-MCP-Server.git
  45. cd Google-Scholar-MCP-Server
  46. # Create and activate virtual environment
  47. python -m venv venv
  48. source venv/bin/activate # On Windows use `venv\Scripts\activate`
  49. # Install dependencies
  50. pip install -r requirements.txt
  51. ```
  52. ## πŸ“Š Usage
  53. Start the MCP server:
  54. ```bash
  55. python google_scholar_server.py
  56. ```
  57. 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:
  58. ### Example 1: Search for papers using keywords
  59. ```python
  60. result = await mcp.use_tool("search_google_scholar_key_words", {
  61. "query": "artificial intelligence ethics",
  62. "num_results": 5
  63. })
  64. print(result)
  65. ```
  66. ### Example 2: Perform an advanced search
  67. ```python
  68. result = await mcp.use_tool("search_google_scholar_advanced", {
  69. "query": "machine learning",
  70. "author": "Hinton",
  71. "year_range": [2020, 2023],
  72. "num_results": 3
  73. })
  74. print(result)
  75. ```
  76. ### Example 3: Get author information
  77. ```python
  78. result = await mcp.use_tool("get_author_info", {
  79. "author_name": "Geoffrey Hinton"
  80. })
  81. print(result)
  82. ```
  83. 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.
  84. ## Usage with Claude Desktop
  85. Add this configuration to your `claude_desktop_config.json`:
  86. (Mac OS)
  87. ```json
  88. {
  89. "mcpServers": {
  90. "google-scholar": {
  91. "command": "python",
  92. "args": ["-m", "google_scholar_mcp_server"]
  93. }
  94. }
  95. }
  96. ```
  97. (Windows version):
  98. ```json
  99. {
  100. "mcpServers": {
  101. "google-scholar": {
  102. "command": "C:\\Users\\YOUR\\PATH\\miniconda3\\envs\\mcp_server\\python.exe",
  103. "args": [
  104. "D:\\code\\YOUR\\PATH\\Google-Scholar-MCP-Server\\google_scholar_server.py"
  105. ],
  106. "env": {},
  107. "disabled": false,
  108. "autoApprove": []
  109. }
  110. }
  111. }
  112. ```
  113. Using with Cline
  114. ```json
  115. {
  116. "mcpServers": {
  117. "google-scholar": {
  118. "command": "bash",
  119. "args": [
  120. "-c",
  121. "source /home/YOUR/PATH/.venv/bin/activate && python /home/YOUR/PATH/google_scholar_mcp_server.py"
  122. ],
  123. "env": {},
  124. "disabled": false,
  125. "autoApprove": []
  126. }
  127. }
  128. }
  129. ```
  130. ## πŸ›  MCP Tools
  131. The Google Scholar MCP Server provides the following tools:
  132. ### search_google_scholar_key_words
  133. Search for articles on Google Scholar using key words.
  134. **Parameters:**
  135. - `query` (str): Search query string
  136. - `num_results` (int, optional): Number of results to return (default: 5)
  137. **Returns:** List of dictionaries containing article information
  138. ### search_google_scholar_advanced
  139. Perform an advanced search for articles on Google Scholar.
  140. **Parameters:**
  141. - `query` (str): General search query
  142. - `author` (str, optional): Author name
  143. - `year_range` (tuple, optional): Tuple containing (start_year, end_year)
  144. - `num_results` (int, optional): Number of results to return (default: 5)
  145. **Returns:** List of dictionaries containing article information
  146. ### get_author_info
  147. Get detailed information about an author from Google Scholar.
  148. **Parameters:**
  149. - `author_name` (str): Name of the author to search for
  150. **Returns:** Dictionary containing author information
  151. ## πŸ“ Project Structure
  152. - `google_scholar_server.py`: The main MCP server implementation using FastMCP
  153. - `google_scholar_web_search.py`: Contains the web scraping logic for searching Google Scholar
  154. ## πŸ”§ Dependencies
  155. - Python 3.10+
  156. - mcp[cli]>=1.4.1
  157. - scholarly>=1.7.0
  158. - asyncio>=3.4.3
  159. You can install the required dependencies using:
  160. ```bash
  161. pip install -r requirements.txt
  162. ```
  163. ## 🀝 Contributing
  164. Contributions are welcome! Please feel free to submit a Pull Request.
  165. ## πŸ“„ License
  166. This project is licensed under the MIT License.
  167. ## ⚠️ Disclaimer
  168. This tool is for research purposes only. Please respect Google Scholar's terms of service and use this tool responsibly.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.