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

  • 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

  1. Clone o repositório:
git clone https://github.com/jmh108/MCP-server-readability-python.git
cd MCP-server-readability-python
  1. Crie e ative um ambiente virtual:
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate
  1. Instale as dependências:
pip install -r requirements.txt

Início Rápido

  1. Inicie o servidor:
fastmcp run server.py
  1. 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

Licença

Licença MIT - Consulte LICENSE para detalhes.