Web Browser MCP Server

✨ Recursos

🌐 Capacite assistentes de IA a navegar e extrair conteúdo da web por meio de uma interface MCP simples.

O Web Browser MCP Server fornece aos modelos de IA a capacidade de navegar em sites, extrair conteúdo e entender páginas da web por meio do Protocolo de Controle de Mensagens (MCP). Ele permite extração inteligente de conteúdo com seletores CSS e tratamento robusto de erros.

✨ Recursos Principais

• 🎯 Extração Inteligente de Conteúdo: Direcione exatamente o que você precisa com seletores CSS
• ⚡ Extremamente Rápido: Construído com processamento assíncrono para desempenho ideal
• 📊 Metadados Ricos: Capture títulos, links e conteúdo estruturado
• 🛡️ Robusto e Confiável: Tratamento de erros e gerenciamento de tempo limite integrados
• 🌍 Multiplataforma: Funciona em qualquer lugar onde o Python é executado

🚀 Início Rápido

Instalação via Smithery

Para instalar o Web Browser Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install web-browser-mcp-server --client claude

Instalação Manual

Instale usando uv:

uv tool install web-browser-mcp-server

Para desenvolvimento:

# Clone and set up development environment
git clone https://github.com/blazickjp/web-browser-mcp-server.git
cd web-browser-mcp-server

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install with test dependencies
uv pip install -e ".[test]"

🔌 Integração MCP

Adicione esta configuração ao arquivo de configuração do seu cliente MCP:

{
    "mcpServers": {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "web-browser-mcp-server"
            ],
            "env": {
                "REQUEST_TIMEOUT": "30"
            }
        }
    }
}

Para Desenvolvimento:

{
    "mcpServers": {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/web-browser-mcp-server",
                "run",
                "web-browser-mcp-server"
            ],
            "env": {
                "REQUEST_TIMEOUT": "30"
            }
        }
    }
}

💡 Ferramentas Disponíveis

O servidor fornece uma ferramenta poderosa de navegação na web:

browse_webpage

Navegue e extraia conteúdo de páginas da web com seletores CSS opcionais:

# Basic webpage fetch
result = await call_tool("browse_webpage", {
    "url": "https://example.com"
})

# Target specific content with CSS selectors
result = await call_tool("browse_webpage", {
    "url": "https://example.com",
    "selectors": {
        "headlines": "h1, h2",
        "main_content": "article.content",
        "navigation": "nav a"
    }
})

⚙️ Configuração

Configure por meio de variáveis de ambiente:

Variável	Finalidade	Padrão
REQUEST_TIMEOUT	Tempo limite de solicitação de página da web em segundos	30

🧪 Testes

Execute a suíte de testes:

python -m pytest

📄 Licença

Lançado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

---