A
securityA
licenseA
qualityA powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.
Last updated -
4
1,095
37
MIT License
Converts clean HTML from web pages into well-formatted Markdown, optimizing content for LLM processing with consistent formatting.
Leverages Mozilla's Readability algorithm to extract and transform webpage content into clean, LLM-optimized Markdown by removing ads, navigation, footers and other non-essential content.
MCP Server Readability Parser (Python / FastMCP)
Credits/Reference
This project is based on the original server-moz-readability implementation of emzimmer. (For the original README documentation, please refer to the original README.md.)
This Python implementation adapts the original concept to run as python based MCP using FastMCP
Mozilla Readability Parser MCP Server
A Python implementation of the Model Context Protocol (MCP) server that extracts and transforms webpage content into clean, LLM-optimized Markdown.
Table of Contents
Features
Removes ads, navigation, footers and other non-essential content
Converts clean HTML into well-formatted Markdown
Handles errors gracefully
Optimized for LLM processing
Lightweight and fast
Why Not Just Fetch?
Unlike simple fetch requests, this server:
Extracts only relevant content using Readability algorithm
Eliminates noise like ads, popups, and navigation menus
Reduces token usage by removing unnecessary HTML/CSS
Provides consistent Markdown formatting for better LLM processing
Handles complex web pages with dynamic content
Installation
Clone the repository:
git clone https://github.com/jmh108/MCP-server-readability-python.git
cd MCP-server-readability-python
Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows use: venv\Scripts\activate
Install dependencies:
pip install -r requirements.txt
Quick Start
Start the server:
fastmcp run server.py
Example request:
curl -X POST http://localhost:8000/tools/extract_content \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'
Tool Reference
extract_content
Fetches and transforms webpage content into clean Markdown.
Arguments:
{
"url": {
"type": "string",
"description": "The website URL to parse",
"required": true
}
}
Returns:
{
"content": "Markdown content..."
}
MCP Server Configuration
To configure the MCP server, add the following to your MCP settings file:
{
"mcpServers": {
"readability": {
"command": "fastmcp",
"args": ["run", "server.py"],
"env": {}
}
}
}
The server can then be started using the MCP protocol and accessed via the parse tool.
Dependencies
readability-lxml - Content extraction
html2text - HTML to Markdown conversion
beautifulsoup4 - DOM parsing
requests - HTTP requests
License
MIT License - See LICENSE for details.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Python implementation of an MCP server that extracts webpage content, removes ads and non-essential elements, and transforms it into clean, LLM-optimized Markdown.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Python-based MCP server that crawls websites to extract and save content as markdown files, with features for mapping website structure and links.Last updated -3MIT License
- AsecurityAlicenseAqualityAn MCP server that retrieves web page content using Playwright headless browser, capable of extracting main content and converting to Markdown format.Last updated -23,066865MIT License
- AsecurityFlicenseAqualityAn MCP server that extracts meaningful content from websites and converts HTML to high-quality Markdown, using Mozilla's Readability engine.Last updated -16,0887