Semantic Scholar

Pesquise artigos acadêmicos, autores e citações usando a API do Semantic Scholar.

Documentação

🎓 Servidor MCP do Semantic Scholar

smithery badge

Este projeto implementa um servidor Model Context Protocol (MCP) para interagir com a API do Semantic Scholar. Ele fornece ferramentas para pesquisar artigos, obter detalhes de artigos e autores, e buscar citações e referências.

✨ Recursos

  • 🔍 Pesquisar artigos no Semantic Scholar
  • 📄 Obter informações detalhadas sobre artigos específicos
  • 👤 Obter detalhes de autores
  • 🔗 Buscar citações e referências de um artigo

📋 Pré-requisitos

  • 🐍 Python 3.10+
  • 📚 Pacote Python semanticscholar
  • 🔧 Pacote Python mcp (Model Context Protocol)

🚀 Instalação

Instalando via Smithery

Para instalar o servidor semanticscholar para Claude Desktop automaticamente via Smithery:

claude

npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-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/semanticscholar-mcp-server --client cursor --config "{}" 

Windsurf

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

CLine

npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client cline --config "{}"
  1. Clone este repositório:

    git clone https://github.com/JackKuo666/semanticscholar-MCP-Server.git
    cd semanticscholar-mcp-server
    
  2. Instale os pacotes necessários:

    pip install semanticscholar mcp
    

🖥️ Uso

  1. Inicie o servidor MCP do Semantic Scholar:

    python semantic_scholar_server.py
    
  2. O servidor iniciará e ficará aguardando solicitações MCP.

  3. Use um cliente MCP para interagir com o servidor e acessar as seguintes ferramentas:

    • 🔍 search_semantic_scholar: Pesquisar artigos usando uma string de consulta
    • 📄 get_semantic_scholar_paper_details: Obter detalhes de um artigo específico
    • 👤 get_semantic_scholar_author_details: Obter detalhes de um autor específico
    • 🔗 get_semantic_scholar_citations_and_references: Obter citações e referências de um artigo

Uso com Claude Desktop

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

(Mac OS)

{
  "mcpServers": {
    "semanticscholar": {
      "command": "python",
      "args": ["-m", "semanticscholar_mcp_server"]
      }
  }
}

(Versão Windows):

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

Usando com Cline

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

📁 Estrutura de Arquivos

  • 📜 semantic_scholar_search.py: Contém funções para interagir com a API do Semantic Scholar
  • 🖥️ semantic_scholar_server.py: Implementa o servidor MCP e define as ferramentas disponíveis

🤝 Contribuição

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 - consulte o arquivo LICENSE para obter detalhes.