damarals/periodicos-capes-mcp

Introdução

O MCP Server - Periódicos CAPES implementa o protocolo Model Context Protocol para permitir que modelos de linguagem consultem diretamente o Portal de Periódicos CAPES. Especialmente otimizado para revisões sistemáticas de literatura (RSL) e mapeamentos sistemáticos (MSL).

Características

• 🔍 Busca no Portal CAPES (IEEE, ACM, Elsevier, WoS, Scopus, etc.)
• 🛡️ Acesso confiável: Zyte API para bypass automático de proteções
• 📈 Métricas integradas: OpenAlex (citações, FWCI) + Qualis (classificação brasileira)
• 🎛️ Filtros avançados: tipo, acesso aberto, revisão por pares, ano, idioma
• 📤 Export bibliográfico: RIS e BibTeX com pasta estruturada
• 🔬 Reprodutibilidade acadêmica: metadados completos para compliance
• ⚡ Performance otimizada: Acesso direto via API especializada

Instalação

npm install -g periodicos-capes-mcp

Pré-requisitos:

1. Criar conta Zyte: https://zyte.com (necessário para bypass de proteções)
2. Configurar API Key: Adicione sua chave ao arquivo .env:

# .env
ZYTE_API_KEY="sua_chave_aqui"

Configuração Claude Code:

# Adicionar automaticamente
claude mcp add capes periodicos-capes-mcp

Ou configurar manualmente (Claude Code/Desktop):

{
  "mcpServers": {
    "capes": {
      "command": "periodicos-capes-mcp"
    }
  }
}

Como Usar

O servidor fornece 2 funções especializadas otimizadas para diferentes workflows acadêmicos:

1. preview_search - Preview Rápido

Visualização rápida dos resultados para decidir se vale a pena refinar a busca.

Parâmetros:

Exemplo:

{
  "query": "machine learning healthcare",
  "filters": {
    "year_range": [2020, 2024],
    "document_types": ["Artigo"],
    "open_access_only": true
  }
}

Resposta:

{
  "query": "machine learning healthcare",
  "total_found": 2847,
  "sample_titles": [