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 artigostodas_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 artigostodas_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
- Clone ou baixe os arquivos do servidor
- Instale as dependências:
npm install
- 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