Read URL MCP

Extrae contenido web de una URL y lo convierte a formato Markdown limpio.

Documentación

Read URL MCP

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de lectura de URL, extrayendo contenido web y convirtiéndolo a formato Markdown limpio.

Características

  • Obtener contenido web de URLs HTTP/HTTPS
  • Extraer contenido principal usando algoritmo de legibilidad
  • Convertir HTML a formato Markdown limpio
  • Tiempo de espera y límites de tamaño de contenido configurables

Instalación

uv install

Configuración de MCP

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

Uso

Ejecute el servidor MCP:

uv run python read_url_mcp/mcp_server.py

Herramientas Disponibles

  • readURLMarkdown(url: str) - Obtiene el contenido de la URL y lo devuelve como Markdown

Desarrollo

Calidad del Código

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

Dependencias

  • mcp[cli] - Marco de trabajo MCP
  • requests - Cliente HTTP
  • readability-lxml - Extracción de contenido
  • html2text - Conversión de HTML a Markdown

Configuración

Configuración del servidor en mcp_server.py:

  • Tiempo de espera: 30 segundos
  • Longitud máxima de contenido: 1MB
  • Agente de usuario: my-mcp-tools/1.0