Web Browser MCP Server

✨ Características

🌐 Permite que los asistentes de IA naveguen y extraigan contenido de la web a través de una interfaz MCP simple.

El Web Browser MCP Server proporciona a los modelos de IA la capacidad de navegar por sitios web, extraer contenido y comprender páginas web a través del Protocolo de Control de Mensajes (MCP). Permite la extracción inteligente de contenido con selectores CSS y un manejo robusto de errores.

✨ Características principales

• 🎯 Extracción inteligente de contenido: Apunta exactamente a lo que necesitas con selectores CSS
• ⚡ Rápido como un rayo: Construido con procesamiento asíncrono para un rendimiento óptimo
• 📊 Metadatos enriquecidos: Captura títulos, enlaces y contenido estructurado
• 🛡️ Robusto y confiable: Manejo de errores y gestión de tiempos de espera integrados
• 🌍 Multiplataforma: Funciona en cualquier lugar donde se ejecute Python

🚀 Inicio rápido

Instalación mediante Smithery

Para instalar Web Browser Server para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

Instala usando uv:

uv tool install web-browser-mcp-server

Para desarrollo:

# 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]"

🔌 Integración MCP

Agrega esta configuración a tu archivo de configuración del cliente MCP:

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

Para desarrollo:

{
    "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"
            }
        }
    }
}

💡 Herramientas disponibles

El servidor proporciona una potente herramienta de navegación web:

browse_webpage

Navega y extrae contenido de páginas web con selectores CSS opcionales:

# 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"
    }
})

⚙️ Configuración

Configura a través de variables de entorno:

Variable	Propósito	Valor predeterminado
REQUEST_TIMEOUT	Tiempo de espera de solicitud de página web en segundos	30

🧪 Pruebas

Ejecuta el conjunto de pruebas:

python -m pytest

📄 Licencia

Publicado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

---