Package Exports

periodicos-capes-mcp
periodicos-capes-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (periodicos-capes-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

MCP Server - Periódicos CAPES

Servidor MCP para Consulta de Periódicos Científicos

Ferramenta otimizada para buscar e analisar artigos científicos do Portal de Periódicos CAPES
através do protocolo Model Context Protocol (MCP).

_{Desenvolvido por Daniel Amaral 👨‍💻}

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:

Criar conta Zyte: https://zyte.com (necessário para bypass de proteções)
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:

Parâmetro	Tipo	Obrigatório	Descrição
`query`	string	✓	String de busca
`filters`	object	✗	Filtros a aplicar (veja seção Filtros)

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": [
    "Machine Learning Applications in Healthcare...",
    "Deep Learning for Medical Diagnosis...",
    "AI in Clinical Decision Support Systems..."
  ],
  "filters_applied": { ... }
}

2. `search_articles` - Busca e Export Unificados

Busca artigos no Portal CAPES e exporta automaticamente para pasta estruturada com arquivo bibliográfico + metadados.

Parâmetros:

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`query`	string	✓	-	String de busca
`format`	string	✓	-	Formato: `"ris"` ou `"bibtex"`
`filters`	object	✗	-	Filtros a aplicar
`max_results`	number	✗	-	Máximo de artigos a exportar

Exemplo:

{
  "query": "systematic review machine learning",
  "format": "ris",
  "max_results": 500,
  "filters": {
    "year_range": [2020, 2024],
    "document_types": ["Artigo", "Revisão"]
  }
}

Resultado:

capes_export_2025-01-15T14-30-52/
├── metadata.json          ← Metadados completos para reprodutibilidade
└── capes_export_143052.ris ← Arquivo para import no Zotero/Mendeley

Filtros Disponíveis

Todos os filtros são opcionais e podem ser combinados:

{
  "filters": {
    "document_types": ["Artigo", "Capítulo de livro", "Carta", "Errata", "Revisão"],
    "open_access_only": true,  // true=só aberto, false=só fechado, undefined=todos
    "peer_reviewed_only": true, // true=só revisado, false=só não-revisado, undefined=todos
    "year_range": [2020, 2024], // [ano_min, ano_max]
    "languages": ["Inglês", "Português", "Espanhol", "Francês", "Alemão", "Italiano"]
  }
}

Desenvolvimento

# Clonar repositório
git clone https://github.com/damarals/periodicos-capes-mcp.git
cd periodicos-capes-mcp

# Instalar dependências
npm install

# Compilar
npm run build

# Executar
npm start

Contribuindo

Contribuições são sempre bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests. Se encontrar algum problema ou quiser sugerir uma melhoria, não hesite em contribuir.

Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

periodicos-capes-mcp