Read URL MCP Server

Extracts web content from a URL and converts it to clean Markdown format.

GitHub

Documentation

Read URL MCP

A Model Context Protocol (MCP) server that provides URL reading capabilities, extracting web content and converting it to clean Markdown format.

Features

  • Fetch web content from HTTP/HTTPS URLs
  • Extract main content using readability algorithm
  • Convert HTML to clean Markdown format
  • Configurable timeout and content size limits

Installation

uv install

MCP Setting

{
    "mcpServers": {
        "read_url_mcp": {
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "<directory>",
                "read_url_mcp/mcp_server"
            ],
            "env": {
                "PYTHONPATH": "<directory>"
            }
        }
    }
}

Usage

Run the MCP server:

uv run python read_url_mcp/mcp_server.py

Available Tools

  • readURLMarkdown(url: str) - Fetches URL content and returns it as Markdown

Development

Code Quality

uv run ruff check          # Lint code
uv run ruff format         # Format code
uv run ruff check --fix    # Auto-fix issues

Dependencies

  • mcp[cli] - MCP framework
  • requests - HTTP client
  • readability-lxml - Content extraction
  • html2text - HTML to Markdown conversion

Configuration

Server settings in mcp_server.py:

  • Timeout: 30 seconds
  • Max content length: 1MB
  • User agent: my-mcp-tools/1.0