Mozilla Readability MCP Server

This is a Model Context Protocol (MCP) server for Mozilla's Readability.js library. It exposes a tool to parse a web page and extract its main article content, stripping away clutter.

Features

• Article Parsing: Extracts the main readable content from any given URL.
• MCP Integration: Seamlessly integrates with any MCP-compatible client (e.g., Kilo Code, Claude Desktop).

Tools

parse

Parses an article from a URL and returns a readable version of it.

Parameters:

• url (string, required): The URL of the article to parse.

Returns:

A JSON object containing the parsed article, with the following properties:

• title: article title
• content: HTML string of processed article content
• textContent: text content of the article, with all the HTML tags removed
• length: length of an article, in characters
• excerpt: article description, or short excerpt from the content
• byline: author metadata
• dir: content direction
• siteName: name of the site
• lang: content language
• publishedTime: published time

Usage with an MCP Client

To use this server with an MCP client like Kilo Code or Claude Desktop, you need to add it to your MCP configuration file. The server can be run directly using npx without needing to clone or install it manually.

Example mcp.json / claude_desktop_config.json configuration:

{
  "mcpServers": {
    "mozilla-readability": {
      "command": "npx",
      "args": [
        "-y",
        "@tinkergrove/mozilla-readability-mcp-server"
      ]
    }
  }
}

Once configured, your MCP client will automatically download and run the server, and you can use the parse tool.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.