Readability (Fetch & Parse)
About
Extracts and transforms webpage content into clean, LLM-optimized Markdown by removing non-essential elements while preserving key metadata.
Details
- Author
- jmh108
- Repository
- jmh108/MCP-server-readability-python
- GitHub stars
- 3
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, AI, Search, Infrastructure, Security, Frontend, Web Scraping, Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Readability (Fetch & Parse)Command (node, npx, python, etc.)fastmcpArguments-
Argument 1
run -
Argument 2
server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Start the server:
fastmcp run server.py
2. Example request:
curl -X POST http://localhost:8000/tools/extract_content \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article"}'
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.
extract_content
Fetches and transforms webpage content into clean Markdown. Parameters: url (string) - The website URL to parse.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"readability (fetch & parse)": {
"env": {},
"args": [
"run",
"server.py"
],
"command": "fastmcp"
}
}
}Linux
{
"env": [],
"args": [
"run",
"server.py"
],
"command": "fastmcp"
}Macos
{
"env": [],
"args": [
"run",
"server.py"
],
"command": "fastmcp"
}Windows
{
"env": [],
"args": [
"run",
"server.py"
],
"command": "fastmcp"
}Extracts and transforms webpage content into clean, LLM-optimized Markdown using the Readability algorithm.
MCP Server Readability Parser (Python / FastMCP)
This project is based on the originalserver-moz-readabilityimplementation ofemzimmer. (For the original README documentation, please refer to theoriginal README.md.)
This Python implementation adapts the original concept to run as python based MCP usingFastMCP
A Python implementation of theModel Context Protocol (MCP)server that extracts and transforms webpage content into clean, LLM-optimized Markdown.
- Features
- Why Not Just Fetch?
- Installation
- Quick Start
- Tool Reference
- Dependencies
- License
- 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
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
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
curl -X POST http://localhost:8000/tools/extract_content \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com/article"}'
Fetches and transforms webpage content into clean Markdown.
{ "url": { "type": "string", "description": "The website URL to parse", "required": true } }
{ "content": "Markdown content..." }
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 theparsetool.
- readability-lxml- Content extraction
- html2text- HTML to Markdown conversion
- beautifulsoup4- DOM parsing
- requests- HTTP requests
Fetches web pages and converts them to clean markdown, focusing on main content extraction.
Fetches web content from a URL and converts it from HTML to markdown for easier consumption by LLMs.
Fetch web pages and convert HTML to clean, formatted Markdown. Handles large pages with automatic file saving to bypass token limits.
Local-first MCP server that captures web URLs (X, Reddit, YouTube, Wikipedia, articles) as typed data + Markdown into a self-hosted capture/store/recall substrate, with offline semantic recall. Six tools over a local khiipd daemon; run khiipd serve first.
Download webpages as markdown files using the r.jina.ai service, with configurable directories and persistent settings.
Fetches content from any URL and converts it to HTML, JSON, Markdown, or plain text.
Extracts and transforms webpage content into clean, LLM-optimized Markdown using Mozilla's Readability algorithm.
Convert any URL to clean, LLM-ready Markdown
Extracts web content from a URL and converts it to clean Markdown format.
An MCP server for the Urlbox Screenshot API. It enables your client to take screenshots, generate PDFs, extract HTML/markdown, and more from websites.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
