Google Scholar

Google Scholar MCP Server

🔍 Permita que assistentes de IA pesquisem e acessem artigos do Google Scholar através de uma interface MCP simples.

O Google Scholar MCP Server fornece uma ponte entre assistentes de IA e o Google Scholar através do Model Context Protocol (MCP). Ele permite que modelos de IA pesquisem artigos acadêmicos e acessem seu conteúdo de forma programática.

✨ Recursos Principais

• 🔎 Pesquisa de Artigos: Consulte artigos do Google Scholar com strings de pesquisa personalizadas ou parâmetros de pesquisa avançados ✅
• 🚀 Recuperação Eficiente: Acesso rápido aos metadados dos artigos ✅
• 👤 Informações do Autor: Recupere informações detalhadas sobre autores ✅
• 📊 Suporte à Pesquisa: Facilite a pesquisa e análise acadêmica ✅

🚀 Início Rápido

Instalação Manual

Instalação via Smithery

Para instalar o servidor google-scholar para Claude Desktop automaticamente via Smithery:

claude

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

Cursor

Cole o seguinte em Configurações → Configurações do Cursor → MCP → Adicionar novo 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 "{}"

1. Clone o repositório:

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

2. Instale as dependências necessárias:

   pip install -r requirements.txt
   

Para desenvolvimento:

# 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

Inicie o servidor MCP:

python google_scholar_server.py

Depois que o servidor estiver em execução, você pode usar as ferramentas MCP fornecidas no seu assistente de IA ou aplicativo. Aqui estão alguns exemplos de como usar as ferramentas:

Exemplo 1: Pesquisar artigos usando palavras-chave

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

Exemplo 2: Realizar uma pesquisa avançada

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

Exemplo 3: Obter informações do autor

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

Esses exemplos demonstram como usar as três principais ferramentas fornecidas pelo Google Scholar MCP Server. Ajuste os parâmetros conforme necessário para o seu caso de uso específico.

Uso com Claude Desktop

Adicione esta configuração ao seu claude_desktop_config.json:

(Mac OS)

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

(Versão 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": []
    }
  }
}

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

🛠 Ferramentas MCP

O Google Scholar MCP Server fornece as seguintes ferramentas:

search_google_scholar_key_words

Pesquise artigos no Google Scholar usando palavras-chave.

Parâmetros:

• query (str): String de consulta de pesquisa
• num_results (int, opcional): Número de resultados a retornar (padrão: 5)

Retorna: Lista de dicionários contendo informações do artigo

search_google_scholar_advanced

Realize uma pesquisa avançada por artigos no Google Scholar.

Parâmetros:

• query (str): Consulta de pesquisa geral
• author (str, opcional): Nome do autor
• year_range (tupla, opcional): Tupla contendo (start_year, end_year)
• num_results (int, opcional): Número de resultados a retornar (padrão: 5)

Retorna: Lista de dicionários contendo informações do artigo

get_author_info

Obtenha informações detalhadas sobre um autor do Google Scholar.

Parâmetros:

• author_name (str): Nome do autor a pesquisar

Retorna: Dicionário contendo informações do autor

📁 Estrutura do Projeto

• google_scholar_server.py: A implementação principal do servidor MCP usando FastMCP
• google_scholar_web_search.py: Contém a lógica de web scraping para pesquisar no Google Scholar

🔧 Dependências

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

Você pode instalar as dependências necessárias usando:

pip install -r requirements.txt

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📄 Licença

Este projeto está licenciado sob a Licença MIT.

⚠️ Aviso Legal

Esta ferramenta é apenas para fins de pesquisa. Respeite os termos de serviço do Google Scholar e use esta ferramenta com responsabilidade.