Read URL MCP

Read URL MCP

Um servidor Model Context Protocol (MCP) que fornece capacidades de leitura de URLs, extraindo conteúdo web e convertendo-o para o formato Markdown limpo.

Recursos

• Buscar conteúdo web de URLs HTTP/HTTPS
• Extrair conteúdo principal usando algoritmo de legibilidade
• Converter HTML para o formato Markdown limpo
• Tempo limite e limites de tamanho de conteúdo configuráveis

Instalação

uv install

Configuração do MCP

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

Uso

Execute o servidor MCP:

uv run python read_url_mcp/mcp_server.py

Ferramentas Disponíveis

• readURLMarkdown(url: str) - Busca o conteúdo da URL e o retorna como Markdown

Desenvolvimento

Qualidade do Código

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

Dependências

• mcp[cli] - framework MCP
• requests - cliente HTTP
• readability-lxml - extração de conteúdo
• html2text - conversão de HTML para Markdown

Configuração

Configurações do servidor em mcp_server.py:

• Tempo limite: 30 segundos
• Tamanho máximo de conteúdo: 1MB
• User agent: my-mcp-tools/1.0