Readability Parser
Extrai e transforma o conteúdo de páginas da web em Markdown limpo e otimizado para LL
Documentação
Servidor MCP Readability Parser (Python / FastMCP)
Créditos/Referência
Este projeto é baseado na implementação original server-moz-readability de emzimmer. (Para a documentação README original, consulte o README.md original.)
Esta implementação em Python adapta o conceito original para funcionar como um MCP baseado em Python usando FastMCP
Servidor MCP Mozilla Readability Parser
Uma implementação em Python do servidor Model Context Protocol (MCP) que extrai e transforma o conteúdo de páginas da web em Markdown limpo e otimizado para LLMs.
Sumário
- Recursos
- Por que não apenas buscar?
- Instalação
- Início Rápido
- Referência de Ferramentas
- Dependências
- Licença
Recursos
- Remove anúncios, navegação, rodapés e outros conteúdos não essenciais
- Converte HTML limpo em Markdown bem formatado
- Trata erros com elegância
- Otimizado para processamento por LLMs
- Leve e rápido
Por que não apenas buscar?
Diferente de simples requisições de busca, este servidor:
- Extrai apenas o conteúdo relevante usando o algoritmo Readability
- Elimina ruídos como anúncios, pop-ups e menus de navegação
- Reduz o uso de tokens removendo HTML/CSS desnecessários
- Fornece formatação Markdown consistente para melhor processamento por LLMs
- Lida com páginas web complexas e conteúdo dinâmico
Instalação
- Clone o repositório:
git clone https://github.com/jmh108/MCP-server-readability-python.git
cd MCP-server-readability-python
- Crie e ative um ambiente virtual:
python -m venv venv
source venv/bin/activate # On Windows use: venv\Scripts\activate
- Instale as dependências:
pip install -r requirements.txt
Início Rápido
- Inicie o servidor:
fastmcp run server.py
- Exemplo de requisição:
curl -X POST http://localhost:8000/tools/extract_content \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'
Referência de Ferramentas
extract_content
Busca e transforma o conteúdo de páginas da web em Markdown limpo.
Argumentos:
{
"url": {
"type": "string",
"description": "The website URL to parse",
"required": true
}
}
Retorno:
{
"content": "Markdown content..."
}
Configuração do Servidor MCP
Para configurar o servidor MCP, adicione o seguinte ao seu arquivo de configurações MCP:
{
"mcpServers": {
"readability": {
"command": "fastmcp",
"args": ["run", "server.py"],
"env": {}
}
}
}
O servidor pode então ser iniciado usando o protocolo MCP e acessado por meio da ferramenta parse.
Dependências
- readability-lxml - Extração de conteúdo
- html2text - Conversão de HTML para Markdown
- beautifulsoup4 - Análise de DOM
- requests - Requisições HTTP
Licença
Licença MIT - Consulte LICENSE para detalhes.