Google Scholar

Busca y accede a artículos académicos en Google Scholar.

Documentación

Google Scholar MCP Server

🔍 Permite a los asistentes de IA buscar y acceder a artículos de Google Scholar a través de una interfaz MCP simple.

El servidor MCP de Google Scholar proporciona un puente entre los asistentes de IA y Google Scholar a través del Protocolo de Contexto de Modelo (MCP). Permite a los modelos de IA buscar artículos académicos y acceder a su contenido de forma programática.

✨ Características principales

🔎 Búsqueda de artículos: Consulta artículos de Google Scholar con cadenas de búsqueda personalizadas o parámetros de búsqueda avanzada ✅
🚀 Recuperación eficiente: Acceso rápido a los metadatos de los artículos ✅
👤 Información de autor: Recupera información detallada sobre los autores ✅
📊 Soporte de investigación: Facilita la investigación y el análisis académico ✅

🚀 Inicio rápido

Instalación manual

Instalación a través de Smithery

Para instalar el servidor google-scholar para Claude Desktop automáticamente a través de Smithery:

claude

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

Cursor

Pega lo siguiente en Configuración → Configuración de Cursor → MCP → Agregar nuevo servidor:

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 "{}"

Clona el repositorio:

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

Instala las dependencias requeridas:
```
pip install -r requirements.txt
```

Para desarrollo:

# 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

📊 Uso

Inicia el servidor MCP:

python google_scholar_server.py

Una vez que el servidor esté en ejecución, puedes usar las herramientas MCP proporcionadas en tu asistente de IA o aplicación. Aquí hay algunos ejemplos de cómo usar las herramientas:

Ejemplo 1: Buscar artículos usando palabras clave

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

Ejemplo 2: Realizar una búsqueda avanzada

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

Ejemplo 3: Obtener información del autor

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

Estos ejemplos demuestran cómo usar las tres herramientas principales proporcionadas por el servidor MCP de Google Scholar. Ajusta los parámetros según sea necesario para tu caso de uso específico.

Uso con Claude Desktop

Agrega esta configuración a tu claude_desktop_config.json:

(Mac OS)

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

(Versión de 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": []
    }
  }
}

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

🛠 Herramientas MCP

El servidor MCP de Google Scholar proporciona las siguientes herramientas:

search_google_scholar_key_words

Busca artículos en Google Scholar usando palabras clave.

Parámetros:

query (str): Cadena de consulta de búsqueda
num_results (int, opcional): Número de resultados a devolver (por defecto: 5)

Devuelve: Lista de diccionarios que contienen información del artículo

search_google_scholar_advanced

Realiza una búsqueda avanzada de artículos en Google Scholar.

Parámetros:

query (str): Consulta de búsqueda general
author (str, opcional): Nombre del autor
year_range (tuple, opcional): Tupla que contiene (start_year, end_year)
num_results (int, opcional): Número de resultados a devolver (por defecto: 5)

Devuelve: Lista de diccionarios que contienen información del artículo

get_author_info

Obtén información detallada sobre un autor de Google Scholar.

Parámetros:

author_name (str): Nombre del autor a buscar

Devuelve: Diccionario que contiene información del autor

📁 Estructura del proyecto

google_scholar_server.py: La implementación principal del servidor MCP usando FastMCP
google_scholar_web_search.py: Contiene la lógica de web scraping para buscar en Google Scholar

🔧 Dependencias

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

Puedes instalar las dependencias requeridas usando:

pip install -r requirements.txt

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción (Pull Request).

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.

⚠️ Aviso legal

Esta herramienta es solo para fines de investigación. Respeta los términos de servicio de Google Scholar y úsala de manera responsable.