# 🎓 MCP Acadêmico

Servidor MCP (Model Context Protocol) para auxiliar na escrita de artigos acadêmicos, dissertações e teses. Extrai, organiza e referencia artigos científicos em PDF com formatação ABNT.

## O que este MCP faz

| Ferramenta | Função |
|---|---|
| `listar_artigos` | Lista todos os artigos cadastrados e PDFs disponíveis |
| `cadastrar_artigo` | Registra metadados de um artigo (autores, título, DOI, etc.) |
| `extrair_pdf` | Extrai o texto completo de um PDF (com cache) |
| `fichar_artigo` | Prepara fichamento estruturado (resumo, método, citações) |
| `buscar_nos_artigos` | Busca um termo em todos os artigos de uma vez |
| `extrair_citacao` | Gera referência ABNT completa, citação direta ou indireta |
| `comparar_metodologias` | Compara metodologias de múltiplos artigos |
| `estruturar_artigo` | Sugere estrutura completa para seu artigo de mestrado |
| `gerar_secao` | Prepara material de referência para escrever uma seção específica |
| `limpar_cache` | Limpa o cache de textos extraídos |

---

## Instalação

### 1. Instalar dependências

```bash
cd mcp-academico
npm install
```

### 2. Compilar

```bash
npm run build
```

### 3. Configurar no Claude Code

Adicione no seu arquivo `~/.claude/claude_desktop_config.json` (ou `%APPDATA%\Claude\claude_desktop_config.json` no Windows):

```json
{
  "mcpServers": {
    "academico": {
      "command": "node",
      "args": ["C:\\Users\\werve\\Downloads\\claude\\mcp-academico\\dist\\index.js"]
    }
  }
}
```

**Alternativa via `settings.json`** (Claude Code CLI):

```json
{
  "mcpServers": {
    "academico": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "C:\\Users\\werve\\Downloads\\claude\\mcp-academico"
    }
  }
}
```

---

## Fluxo de Uso Recomendado

### Passo 1: Coloque seus PDFs
Copie todos os PDFs dos artigos para a pasta `referencias/`.

### Passo 2: Cadastre os metadados
Para cada artigo, use `cadastrar_artigo`:

```
→ Use a ferramenta cadastrar_artigo para cadastrar o artigo com:
  id: "silva2023"
  arquivo: "silva2023.pdf"
  titulo: "Uma Análise da Aplicação de IA na Educação Brasileira"
  autores: [{"sobrenome":"Silva","nome":"João"},{"sobrenome":"Santos","nome":"Maria"}]
  ano: 2023
  tipo: "artigo"
  revista: "Revista Brasileira de Educação"
  doi: "10.1234/rbe.2023.001"
```

### Passo 3: Extraia os textos
```
→ Use extrair_pdf para extrair o texto de "silva2023.pdf"
```

### Passo 4: Faça fichamentos
```
→ Use fichar_artigo para fazer o fichamento de "silva2023"
```

### Passo 5: Estruture seu artigo
```
→ Use estruturar_artigo com tema: "Aplicação de IA na Educação"
```

### Passo 6: Escreva seção por seção
```
→ Use gerar_secao com secao: "referencial_teorico" e tema_pesquisa: "IA na educação"
→ Depois use buscar_nos_artigos para aprofundar em conceitos específicos
→ Use extrair_citacao com tipo_citacao: "direta" para citações textuais
```

---

## Formato ABNT

O MCP gera automaticamente citações no formato ABNT:

**Citação inline (dentro do texto):**
- 1 autor: `(Silva, 2024)`
- 2 autores: `(Silva; Santos, 2024)`
- 3+ autores: `(Silva et al., 2024)`

**Referência completa:**
> SILVA, João Paulo; SANTOS, Maria Clara. Título do artigo. **Revista Brasileira de Pesquisa Exemplo**, São Paulo, v. 15, n. 2, p. 123-145, jan./jun. 2024. DOI: 10.1234/exemplo.2024.001.

---

## Dicas

1. **Mantenha o `artigos.json` organizado** — quanto mais completos os metadados, melhores as citações
2. **Use `buscar_nos_artigos` antes de escrever cada seção** — encontra conexões entre autores que você pode não ter notado
3. **Compare metodologias** com `comparar_metodologias` — ajuda muito a justificar suas escolhas metodológicas
4. **Cache é automático** — PDFs extraídos uma vez não precisam ser processados novamente
5. **Para PDFs grandes**, use o parâmetro `paginas` do `extrair_pdf` para ler apenas a seção que interessa

---

## Solução de Problemas

| Problema | Solução |
|---|---|
| `pdf-parse não está instalado` | Rode `npm install` |
| PDF não extrai texto | O PDF pode ser de imagem escaneada. Converta para PDF com texto usando OCR (ex: Adobe Acrobat, PDF24) |
| "Arquivo não encontrado" | Verifique se o PDF está na pasta `referencias/` e o nome está correto no cadastro |
| Cache desatualizado | Use `limpar_cache` para forçar re-extração |