MCP Server Fichador

Um servidor MCP (Model Context Protocol) para buscar artigos educacionais no site todamateria.com.br e criar fichas de leitura automatizadas.

Funcionalidades

Este servidor MCP oferece três ferramentas principais:

1. buscar_artigos

Busca artigos no site todamateria.com.br baseado em um termo de pesquisa.

Parâmetros:

• termo_busca (string, obrigatório): Termo para buscar nos artigos
• todas_paginas (boolean, opcional): Se deve buscar em todas as páginas ou apenas na primeira (padrão: false)

Retorna: Lista de artigos encontrados com título e URL.

2. raspar_conteudo

Extrai o conteúdo completo de uma página específica do site.

Parâmetros:

• url (string, obrigatório): URL da página para extrair o conteúdo

Retorna: Conteúdo completo da página incluindo título, texto, imagens, autor e citação.

3. criar_fichas_leitura

Função completa que busca artigos, extrai conteúdo e cria fichas de leitura estruturadas.

Parâmetros:

• termo_busca (string, obrigatório): Termo para buscar nos artigos
• todas_paginas (boolean, opcional): Se deve buscar em todas as páginas (padrão: false)
• salvar (boolean, opcional): Se deve salvar as fichas em arquivo JSON (padrão: true)
• prompt_customizado (string, opcional): Prompt customizado para geração das fichas

Retorna: Fichas de leitura completas com resumo, palavras-chave, pontos principais, etc.

Instalação

1. Clone ou baixe os arquivos do servidor
2. Instale as dependências:

npm install

3. Compile o TypeScript:

npm run build

Uso

Como servidor MCP standalone

npm start

Integração com Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "fichador": {
      "command": "node",
      "args": ["/caminho/para/seu/projeto/dist/index.js"],
      "env": {}
    }
  }
}

Desenvolvimento

Para executar em modo de desenvolvimento:

npm run dev

Estrutura das Fichas de Leitura

Cada ficha de leitura contém:

interface FichaLeitura {
  titulo: string;           // Título do artigo
  resumo: string;           // Resumo do conteúdo
  palavrasChave: string[];  // Palavras-chave extraídas
  temaPrincipal: string;    // Tema principal do artigo
  pontosPrincipais: string[]; // Pontos principais do conteúdo
  url: string;              // URL do artigo original
  autor: string;            // Autor do artigo
  citacao: string;          // Citação formatada
}

Exemplos de Uso

Buscar artigos sobre física:

{
  "name": "buscar_artigos",
  "arguments": {
    "termo_busca": "física quântica",
    "todas_paginas": false
  }
}

Criar fichas de leitura sobre matemática:

{
  "name": "criar_fichas_leitura",
  "arguments": {
    "termo_busca": "equações diferenciais",
    "todas_paginas": true,
    "salvar": true
  }
}

Extrair conteúdo de uma página específica:

{
  "name": "raspar_conteudo",
  "arguments": {
    "url": "https://www.todamateria.com.br/fisica-quantica/"
  }
}

Arquivos Gerados

Quando salvar: true é usado na função criar_fichas_leitura, as fichas são salvas em:

dados/fichas-leitura-{termo_busca}.json

Limitações

• Funciona especificamente com o site todamateria.com.br
• A geração de fichas usa uma implementação simplificada (pode ser integrada com APIs de IA para melhor qualidade)
• Depende da estrutura HTML do site (pode quebrar se o site mudar)

Contribuições

Sinta-se à vontade para contribuir com melhorias, correções ou novas funcionalidades!

Licença

MIT